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WARNING 


This equipment generates, uses, and can radiate 
radio frequency energy and if not installed and 
used in accordance with the instructions manual, 
may cause interference to radio communications. It 
has been tested and found to comply with the limits 
for a Class A computing device pursuant to Subpart 
J of Part 15 of FCC Rules, which are designed to 
provide reasonable protection against such 
interference when operated in a commercial 
environment. Operation of this equipment in a 
residential area is likely to cause interference in 
which case the user at his own expense will be 
required to take whatever measures may be required 
to correct the interference. 


1) 


2) 


Conventions used in this Manual 


Any keys which have labelled caps will be called by their 
full names, capitalized and underlined. For example, the 
Carriage return key will be denoted by: 


RETURN 


The modifier keys, CTRL, SHIFT, Ml and M2, must be held down 
while striking the key they are to modify. Note that these 
four keys do not generate any characters on their own, but 
Simply modify the character which is struck simultaneously. 
This process of holding down a modifier key while striking 
another key will be denoted by the modifier AND the key being 
underlined together. For example, 


CTRL F 


would indicate that the CTRL key should be held down while 
Striking the F key. If two or more modifiers are needed 
Simultaneously, they will all be underlined together: 


CTRL SHIFT T 


would mean that BOTH modifiers, SHIFT and CTRL, should be 
held down while striking the T key. . 


For keys marked with names for these modifiers (CTRL or 
SHIFT only), the modifier will not be specified. For 
example, the View Sub-buffer command is generated by holding 
down the SHIFT key and pressing the key marked REDRAW and 
VIEW; this is represented as: 


VIEW 


(This is a change from the previous manual.) Functions 
without names marked on the key are still represented by 
including the modifier. For example, the command to move the 
cursor to the lower left-hand corner of the window is 
represented as: 


CTRL HOME 


Since this function is not marked on the HOME key. 


3) 


4) 


5) 


Variable parameters will be enclosed in angle brackets, < >. 
Any items enclosed in these brackets will be explained in 
full in the text which immediately follows. 


Optional parameters will be enclosed in square brackets [ ]. 
Any items which may be repeated will be followed by an 
ellipsis (three dots). 


Example of (3) and (4): 

<X>, [<Y1>,<Y¥2>,.06] 
The parameter <X> is required. The parameters <Y1l>, <Y2>, 
and so on, are optional. Any number of these may be 
included. All three types of parameters would be explained 
immediately beneath the example which contained them. 


zeros will be slashed (@); alphabetic O will not be slashed. 
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Preface 


How to Use this Manual 


If you are not familiar with any Chromatics products, 
read Chapter 1, Chapter 2, Chapter4 and Chapter 7 through 
Chapter 9. Appendix A will be a good reference as you 
continue to learn the system. 


Once you have become familiar with the CGC 7909, you 
will want to read Chapter 3, Chapter 5, Chapter 6, Chapter 19 
and Chapter 11. The Appendices will also be helpful. 


Advanced users will want to use this manual mainly as a 
Supplement to the CGC 79®8@ Reference Card. The Reference 
Card contains a complete list of CGC 7988 commands, and a 
very brief description of each one. This manual provides 
more detailed information. 


Changes from the Previous Manual 


The changes in this manual reflect in part the evolution 
of the 7998. The manual has been completely reorganized to 
make it easier to read and to accommodate newer features. If 
you have the old 7988 manual, you may wish to skim through 
this one to note the differences. 


e A new table lists CGC 7998 commands in alphabetical 
order, rather than by Mode, Plot, etc. Another table 
lists the codes generated by each key. 


@ Plot  submodes, Raster Processor commands, Thaw 
parameters and other topics are now under their own 
chapter headings. 


@ Operating systems are discussed to a small extent. 


@e Descriptions of commands in the text are alphabetized 
where possible to make them easier to find. 


e A new Appendix, Appendix E, shows how to add 
user-defined commands to the 79988 and provides some 
"hooks" into the firmware. 
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Chapter 1 -- Introduction 


This is the User's Manual for the Chromatics CGC 7989 Color 
Graphics Computer. It discusses how to operate the 7908. and 
gives examples of the system's capabilities. If you are just 
beginning to learn about the 79099, this is the first manual you 
should read. 

This manual is divided into eleven chapters and six appendices: 


Chapter 1 (this section) discusses the 7908 architecture, 
philosophy and installation. 


Chapter 2 explains philosophy and commands for the Overlay. 


Chapter 3 explains system commands which relate to the 7999 
as a whole. 


Chapter 4 discusses the Terminal Emulator (TERMEM). 
Chapter 5 discusses commands for the Create Buffer. 
Chapter 6 explains CMOS RAM and Thaw parameters. 

Chapter 7 discusses numerical data entry and calculation. 


Chapter 8 discusses Bitmap operations. These include color 
manipulation. Pan and Zoom. and cursor control. 


Chapter 9 explains the various 7999 plot submodes. 
Chapter 168 discusses Raster Processor commands. 


Chapter 11 discusses commands for systems with sixteen image 
planes. 


Appendix lists commands alphabetically and by type. 


discusses the CGC 7900 Monitor. 


A 

Appendix B discusses color display schemes. 
Appendix C 
D 


Appendix lists Trap codes. 

Appendix E is a "cookbook" for subjects such as adding new 
commands to the 799@ repertoire and designing custom cursors 
and character sets. Also included in this appendix is a list 
of "hooks" into the TERMEM firmware. i 


Appendix F is the mandatory ASCII code list. 
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CGC 7909 Overview 


The CGC 7998 is the successor to Chromatics" CG series 
of color graphics computers. Many of the same philosophies 
have been retained in the development of the 79099, and a user 
who is familiar with the CG will quickly become accustomed to 
the 7900. 


The 7990 contains at least three processors: 


@e Most system functions revolve around the MC68999 
processor, selected for its high speed (8 megahertz) 
and large memory addressing range (16 megabytes). 
This powerful processor gives the 7989 outstanding 
capability for stand-alone computing applications. 
And when the 79098 is acting as a terminal (connected 
to a host system), the 7999's power relieves the host 
of many of the tasks normally required in a graphics 
environment. 


e The 79908 also includes a processor in the keyboard, 
and a Raster Processor to provide high performance and 
speed in graphics operations. 


@® Optionally, the 798980 may contain a Serial Port 
Controller with its own on-board 2-88 processor. The 
optional Hardware Vector Generator can also _ be 
considered a processor. 


Many graphics systems suffer from one drawback: they 
require a separate character-oriented terminal for command 
level interaction between the system and the operator. The 
7998 addresses this need by providing a character-oriented 
"Overlay" display in addition to the high-resolution Bitmap 
graphics display. With eight standard colors and blink, the 
Overlay is a very effective tool for operator interaction. 
When not needed, the Overlay can become instantly 
"transparent" to reveal high-resolution graphics images in 
the Bitmap. 


The concept of logical and physical devices, used in the 
Chromatics CG series of computers, has been expanded and 
applied to the 7999. All programs in the 7988 communicate 
only through logical devices, which are numbered 9 through 4. 
7996 software associates each logical device to one or more 
physical devices. This association may be changed at any 
time, allowing total flexibility in programmed input/output. 
Any program can accept input from any physical device, and 
transmit output to any physical device. Some examples of 
physical devices are the keyboard, the serial ports, and the 
7999 display screen. 
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The screen can be subdivided into several distinct areas 
known aS windows. Each window is a separate physical device 
(emulated by software). Thus, each window can be used for a 
separate purpose, and independent simultaneous displays are 
possible. In some applications, one 7999 could replace up to 
16 separate terminals. 

All 79900 features discussed in this manual. and most 
currently available optional features, are contained in a 
Single stand-alone package. Standard features include: 

© 128K or 512K bytes of buffer memory 

® One or four planes of Bitmap image memory 


@ A keyboard with 151 keys (21 lighted) and 24 
user-definable function keys 


@ 8 programmable bezel keys 
® Two serial ports 


® 19-inch color display screen with 1924 x 768 
resolution 


® A PROM firmware package which allows easy control of 
all system functions. 


Cptional features currently include: 
@ Lightpen and joystick for interactive use 
® A battery-backed Real-Time Clock and CMOS memory 


& Disk Operating System (DOS) much like that of the CG 
series 


® Floppy and hard disk drives 
@ Idris Multi-tasking Operating System 


® A Hardware Vector Generator (HVG) which can draw up 
to 27,909 short vectors per second 


® Extended graphics software features 


Version 1.4 Page 1-3 


Overview 7989 Operator's Manual - Chapter 1 


@e Parallel Input/Output and Direct Memory Access 
Interface 


e Serial Port Controller (SPC) with 4 RS-232 ports 
e Disk DMA (with Idris and DOS drivers available) 
e Numerous peripheral interfaces 


& Language support (FORTRAN, C, Pascal) 
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Installation 


Unpack the CGC 798@ according to the instructions 
supplied in the shipping carton. Retain the packing material 
so that it may be used for shipping the 7998 in the future. 


WARNING : 


If your 7989 system includes the optional Fixed 
Disk drive, REMOVE the locking screw and actuator 
lock which was used to secure the drive during 
shipment! See instructions on your unit for 
details. FAILURE TO REMOVE THESE LOCKS WILL 
DESTROY THE HARD DISK, AND VOID YOUR WARRANTY! 


Connect the 7998 power cord to a power source of 1198 
volts AC, 6@ hertz (228 VAC, 58 hertz optional), capable of 
supplying at least 18 amperes. For reliable operation, power 
should NOT come from a circuit with any heavy motors or 
industrial equipment connected which could create transients 
on the power lines. This includes equipment such as 
refrigerators and air conditioners. 


The 7988 has no strict environmental requirements. But, 
like any precision instrument, the 7999 will perform best if 
it is not subjected to excesSive heat or dust. 71908 
ventilation removes heat from the unit through vents in the 
front and rear; these vents should not be obstructed. The 
rear door (and floppy drives, if installed) should be CLOSED 
during normal operation to provide proper air flow through 
the 79990 chassis. 


7999 power is applied by pressing the square, lighted 
Switch on the front of the unit (above the keyboard). The 
Switch is lit whenever the system's five volt power supply is 
Operating. When turning the 7999 on, observe the indicator 
light on the keyboard, just above the cursor keypad. It will 
glow green as the unit performs internal power-on 
diagnostics, and should extinguish after one or two seconds 
(the time this takes is proportional to the amount of user 
memory). By this time, the picture tube should have warmed 
up, and a blinking cursor should be visible on the screen. 


Your 7999 is now running! 
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Booting Software 


Currently, the CGC 7989 supports four operating 
environments: 7 


® The Chromatics Disk Operating System (DOS), a simple 
operating system; 


e Idris, a Unix-like multitasking aah system from 
Whitesmiths, Inc.; 


@e The Terminal Emulator (TERMEM) ; 
@e and the 7909 Monitor. 


Four keys are dedicated to starting these operating 
environments. These are marked DOS, IDRIS, TERMINAL and 
MONITOR. Pressing one of these keys will boot the associated 
environment. 


Typing SHIFT DOS will enter DOS without asking for a 
user password. SHIFT IDRIS enters the Idris Bootstrap 
Loader, which is normally used only to install the full 
Idris. 


More information on DOS and Idris can be found in the 
DOS User's Manual and the Idris User's Manual, respectively. 
This manual describes all the TERMEM commands, and Monitor 
commands are discussed in Appendix C. 
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Keyboard Description 


The 79890 system keyboard is divided into several areas. 
Each area is designed for a specific purpose, and the keys in 
each area are arranged and color-coded for ease of operation. 


In general, keys on the keyboard are marked three ways: 


@e The marking on the top of the key is the primary 
function of that key. Pressing the key alone, without 
using any modifiers, will cause that code to be sent 
from the keyboard. 


@e The marking on the front of the key (if marked in 
white) is the code which is output when the SHIFT 
modifier is used in conjunction with the key (see the 
Conventions page in the front of this manual). 


e The marking on the front of the key (if marked in 
blue) is the code which is output when the CTRL 
modifier is used in conjunction with the key (see the 
Conventions page in the front of this manual). 


In the center of the keyboard, you will find a sculptured, 
typewriter-like set of keys. With few exceptions, these keys 
may be used just as if they were on a standard typewriter. 
On the right of this set are the control keys, RETURN 
(carriage return), LF (line feed), and BREAK (used to 
interrupt a running program). On the left are the modifiers, 
SHIFT, CTRL, Ml, and M2. The high speed REPEAT key is also 
on the left. 


Any key on the keyboard may be caused to repeat, at 
either low or high speed. To repeat a key at low speed, 
Simply hold the key down. To cause high speed repeat, hold 
down both the deSired key and the REPEAT key. 


In the left of this area are the four "prefix" keys 
which the system understands: ESC, USER, MODE, and PLOT. 
Pressing any of these keys is a Signal that one or more other 
_keys will immediately follow, to complete a code sequence. 
To cause the keyboard to output a User code, hold down the 
modifier SHIFT and press the key marked ESC and USER. 
Similarly, for the code Plot, press the SHIFT key and the key 
marked MODE and PLOT. 
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To the far left are two special keys: QUIET LOCK and 
ALPHA LOCK. These two are alternate-action keys. Pressing 
One of these keys will lock it in the down (on) position; 
pressing it again will release it to the up (off) position. 


QUIET LOCK will disconnect the built-in speaker when it 
is in the down (on) position. ALPHA LOCK will reverse the 
case of all letters typed from the typewriter section of the 
keyboard. When it is up (off), letters typed on the 
typewriter keyboard will be upper case when the shift key is 
not being used. They will come out in lower case when the 
shift key is used. (This is the opposite of a normal 
typewriter, but is useful when the unit is acting as a 
terminal.) To reverse this, and return to standard typewriter 
usage, press the ALPHA LOCK key into the down (on) position. 
Now characters typed on the typewriter keyboard will be in 
lower case, and SHIFT will change them to upper case. This 
is most useful for text editing applications. 


To the right of the keyboard are two smaller, special 
purpose keypads. The cursor keypad is used to position the 
cursor, and for text editing functions such as inserting and 
deleting lines. The numeric keypad is a convenient way to 
input numeric data. The keys on the numeric keypad duplicate 
the functions of their counterparts on the typewriter 
keyboard. 


The special function keys on the upper half of the 
keyboard are used to access most of the system's features. 
Most of this manual is dedicated to explaining, in detail, 
what each of these keys will do. In general, the following 
comments apply: 


@ The name on top of the key represents its 
primary function. 


@e The name on the front of the key represents its 
secondary function, and is accessed by holding 
the SHIFT (or CTRL) modifier and pressing the 
key. 


Keys which have a built-in light are keys whose 
Functions may be in one state or the opposite state. For 
example, the BLINK key has a light, and at any time, the 
"blink" attribute may either be on or off. The condition of 
the light will tell which state the system is in. (In some 
cases, it is possible for the keyboard lights to be “out of 
sync" with the rest of the system, in which case they will 
not present true information. See "Keyboard Sync" and 
"Assign" for the details.) 


Page 1-8 Version 1.4 


Chapter l 79908 Operator's Manual Keyboard Description 


Lighted keys have an additional feature: Pressing a 
lighted key will turn a function on if it is off. and turn it 
off if it is currently on. Thus, repeatedly pressing a 
lighted key will toggle the light in that key on and off. 
The function produced by a key depends on whether the light 
in that key is currently on or off. (Using SHIFT with a 
lighted key will. however, always turn the function OFF.) 


The character Control-Z acts as a "flush" command. It 
will clear out the keyboard buffer. so that any keystrokes 
that have not yet been executed will no longer wait in the 
queue. 


To execute the "flush" command, hold down the CTRL 
modifier and press the Z key: 


CTRL Z 
The CALC MODE key is not currently defined. 


A two-color light-emitting diode (LED) is located near 
the cursor keypad. This LED glows green during Reset and 
power-on diagnostics. It will glow red in the event of a 
system failure. 


In addition to the special keys, all commands have a 
code sequence associated with them. If the 7990 is to run 
under the control of a host computer, these code sequences 
must be sent in lieu of a keystroke. Appendix A lists 
commands in alphabetical order, along with its code and 
associated key (if any). 
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CGC 7968 Keyboard 
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Codes and Code Sequences 


The 7900 system is controlled through the keyboard, or 
through a communications port from a host system. The 7/909 
software allows all important system functions to be accessed 
through ASCII characters, which make up codes or _ code 
sequences. A code is a single ASCII character typed on the 
keyboard, or received from a host. A code sequence is a set 
of such characters. 


Certain code sequences cause no immediate change in the 
visible state of the system. Commands such as "Set Color" 
have an effect on future displays, but do not alter anything 
currently being displayed. This can be disconcerting to an 
Operator, Since there is no feedback to indicate that the 
code sequence was accepted properly. It may be helpful to 
compare such code sequences to Similar commands on a familiar 


office typewriter: the "set tab stop" function of a 
typewriter does not generate any feedback to indicate 
acceptance of this command. The command is_- silently 
accepted. 


The 7969 recognizes four "prefix" codes: Escape, User, 
Plot and Mode. When a prefix code is entered, it signals the 
system that one or more additional codes will follow as 
arguments, and that the entire code sequence should be taken 
together to perform a function. 


These prefix codes are NOT the same as the modifiers 
SHIFT, CTRL, Ml and M2. Modifiers do not generate codes; 
they merely alter the key which is pressed simultaneously 
with the modifier. The prefix keys DO generate codes on 
their own, and thus the prefix key must be pressed and 
released before the next key is struck. 


Some of the named keys on the upper part of the keyboard 
cause actions which are equivalent to preSSing more than one 
key on the lower keyboard. For example, pressing RECT to 
enter the "Plot Rectangle" mode, is equivalent to entering 
the sequence PLOT R. This is simply an alternate way of 
entering commands, and we will always use the simplest way to 
describe each command in this manual. See Appendix A for 
detailed information on which keys produce which codes. 
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If you enter a code sequence which is not defined in the 
7966 software, a “bong"™ saind will be produced from the 
Speaker, aS a warning. The same sound will be heard if you 
attempt to access an optional software feature which is not 
installed in your unit. 


Escape Code Sequences 
Format: 
ESC <char> [<argl> <arg2> ...] 


An Escape code sequence consists of the Escape character, 
CTRL [ ($1B), followed by a single character <char> which 
defines the type of Escape code sequence. This may be 
followed by one or more arguments, <arg>, depending on what 
the sequence requires. All arguments fall into one of two 
categories: 


Numbers: decimal or hexadecimal numbers which 
are delimited by a comma Or 
semicolon. 


Characters: a Single ASCII character. 


In addition, a few Escape code sequences will accept an 
arbitrary number of arguments. Details are described in each 
command where applicable. In these cases, a_ special 
delimiter character (usually the semicolon) is used to signal 
the end of the argument list. 


To produce an Escape code sequence, you would press and 
release the ESC key, then press whatever other keys are 
necessary to complete the sequence. The argument list is 
determined by the particular Escape code sequence you are 
executing, and examples will be found throughout this manual. 


Escape code sequences affect the entire machine. They 


control aspects of the operation such as pan and zoom, Color 
Lookup Table assignments, etc. 
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User Code Sequences 
Format: 
USER <char> [<argl> <arg2> ...] 
The User character is produced by holding down the SHIFT key 
and pressing the key marked USER and ESC. The definitions of 


<char> and <arg> are identical to those for Escape code 
sequences. 


User code sequences cause execution of a program, or 
affect the configuration of the 7998 in some manner. Some 
examples of User codes are I/O assignments, duplex selection. 
user-defined function keys, and Create Buffer operations. 


Plot Code Sequences 
Format: 
PLOT <char> 


Where <char> is a single character. A Plot code sequence 
will place the window in a Plot submode, such as Vector. 
Circle, Arc, etc. Plot code sequences affect only the 
currently assigned window. . 


The Plot character is produced by holding down the SHIFT 
modifier key and pressing the key marked PLOT and MODE. 


NOTE: 


The PLOT key used in this context is the key 
labelled Plot and Mode, located in the typewriter 
area of the keyboard. It is NOT the same as the 
lighted PLOT key in the upper keyboard area. The 
lighted PLOT key is used ONLY to move between 
plotting and text entry (Alpha) functions. 
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Mode Code Sequences 
Format: 
MODE <char> [<char>, <char>, ... ] 


Mode code sequences also affect only the currently assigned 
window. They are used in a wide variety of cases, from 
setting colors to scaling character size. Details on the 
available Mode code sequences are found throughout’ this 
manual. 


Code Hierarchy 


The code sequences described on the previous pages are 
arranged in a prioritized structure. It is possible, and 
often desirdle, to interrupt one sequence, enter a higher 
priority sequence, then resume the previous code sequence. 
The priorities are arranged as follows: 


Escape, User Highest Priority 
Mode Intermediate 
Plot Lowest Priority 


A common example would be: while entering coordinates 
to draw a rectangle, you decide to change the foreground 
color. Since coordinates belong to a Plot sequence, and 
colors are higher priority (Mode sequence), you may interrupt 
the coordinates at any time and set a color. Then, you may 
resume entering coordinate data with no lost information. 


Escape and User codes have identical priority, and they 
take higher priority than any other code sequence. ANY Mode, 
Plot, or text entry function may be interrupted by an Escape 
or User code, and the code sequence will be processed. This 
means that important aspects of system operation, controlled 
by Escape and User codes, may be changed at any time, even in 
the middle of coordinate data or text. 
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System Error and Recovery 


The 7960's structure of code sequences is not designed 
to be totally "“user-proof." It is possible to enter a 
Sequence which will force the system into an undefined state. 
However, the RESET key will usually allow recovery from 
errors without losing the work in progress (not true for 
Idris). This problem should not exist if important code 
Sequences are being transmitted only from a host or from an 
applications program (assuming such programs do not contain 
errors). 


The high priority of Escape and User codes can result in 
confusion under certain conditions. The key point is 
this: when an Escape or User code sequence is begun, it MUST 
be completed. For example, the Escape code sequence which 
changes entries in the Color Lookup Table requires four 
arguments: color, red component, green component, and blue 
component. If this sequence is begun by pressing the CHANGE 
key, the system will ignore all other commands until the four 
arguments required by the CHANGE command are satisfied. If 
the system appears to be suddenly unresponsive to commands, 
chances are good that an Escape or User code sequence has 
begun but has not been completed. Typing several commas, to 
Satisfy any pending arguments, will usually regain control of 
the system. 
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Reset, Boot, Soft Boot 


The 7988 recognizes several types of initialization 
procedures. At power-up time, a special type of 
initialization occurs, which erases all memory in the system 
(except CMOS). The image memory is erased, and all of user 
memory is zeroed. 


Pressing the RESET key initializes all hardware to 
default states. All I/O ports are initialized, and all 
buffers are flushed. Any operations in progress”) are 
immediately halted (In fact, Reset may be the only way out 
of some operations.) Following Reset, the Terminal Emulator 
program is executed by default (this may be altered with the 
THAW command). Reset leaves the contents of memory 
essentially unchanged. The Reset command may not be stored 
in the Create Buffer, since it is a hardware function and 
does not generate any code sequence. The most common use of 
the RESET key is to halt a process, such as a picture being 
drawn from the Create Buffer. 


WARNING : 


Under Idris, do NOT press RESET unless you are 
Shutting down the system or if it cannot respond to 
any other stimuli! If you are shutting Idris down, 
perform the "sync" command before hitting RESET. 
Failure to observe these warnings may result in a 
corrupted hard disk! After a reset, Idris will 
have to be rebooted. 


After pressing the RESET key, it may be necessary to 
wait several seconds before the system will again respond to 
input. When the system acknowledges RESET, the green 
indicator near the cursor keypad will light briefly. 


Boot is designed to cold-start the system. It is 
executed by holding down the CTRL key while pressing the key 
marked SOFT BOOT and BOOT. This key is found directly to the 
right of the RESET key. Boot initializes most of the 7968 
system, based on default parameters (either in PROM or in the 
optional battery-powered CMOS memory). After Boot, the 
Terminal Emulator is executed unless CMOS contains orders to 
execute a different program. BOOT is the simplest way to 
reload most of the default parameters in the 7998 system. 
The Boot command may not be stored in the Create Buffer, and 
1S ignored while running under Idris. 


It is possible to simulate most of a power-up reset 
sequence, by pressing the three keys CTRL SHIFT RESET 
Simultaneously (and releasing RESET before releasing the 
other keys). This sequence is equivalent to a Reset followed 
by a Boot, and also erases any image in memory. This 
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Sequence takes longer to execute than the normal RESET, and 
is not usually needed. (It may be required if a user program 
writes into system memory and the RESET key will not recover 
control of the system.) 


CMOS memory (optional) retains information concerning how 
the system is configured at Boot time. CMOS is set up using 
the Thaw command, to define buffer sizes and other defaults. 
As long as the data in CMOS remains intact, it continues to 
be used at Boot time. It is possible for a user to 
sufficiently scramble CMOS data so that the system cannot 
boot; in this case, the keys CTRL SHIFT Ml M2 RESET should be 
pressed simultaneously (releasing RESET first) to clear out 
CMOS and force the system to boot from PROM data instead. 
This sequence destroys any defaults entered by Thaw, so it is 
not recommended unless absolutely necessary. See "Thaw" for 
details. 


NOTE: 


The preceding two sequences (Ml M2 CTRL _ SHIFT 
RESET and CTRL SHIFT RESET) should be used only 
when necessary. Do not get into the habit of uSing 
these sequences, since they will destroy any work 
in progress. 


SOFT BOOT initializes only the window receiving the 
command. it reloads all default window parameters, such as 
color, character size, and other values associated with a 
window. It may be used to set a window to a known state at 
any time. Soft Boot is executed by pressing the SOFT BOOT 
key, and this command may be stored in the Create Buffer. It 
may be used at any time under Idris without disturbing the 
operating system. 


Besides reloading the default window parameters, the 
SOFT BOOT key also erases the Overlay. To reload the window 
parameters without erasing the Overlay, enter the sequence: 


MODE = 


This performs the same functions as the SOFT BOOT key, but 
without erasing anything. 


When beginning a new process on the 7990 system, it is 
usually sufficient to press the SOFT BOOT key. To interrupt 
a process, pressing RESET followed by SOFT BOOT will usually 
suffice. Neither of these key sequences will affect the 
Bitmap image. 
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Convergence and Degaussing 


The 7998 analog circuitry requires periodic adjustment 
for best performance. Convergence adjusts the red, blue and 
green portions of the picture so that they join properly > 
without "fringes" around the edges of the display. 
Degaussing demagnetizes the screen, removing residual 
magnetic fields which can affect color purity. 


Controls for convergence and degaussing are located 
behind the door on the right side of the CRT (picture tube). 
These controls are located so that these operations may be 
conveniently performed whenever necessary. 


The "DE-GAUSS" switch is located at the top of the 
recessed area behind the door. To determine whether the 7999 
needs degaussing, perform the following steps: 


1) Hold down the SHIFT key and press the key marked SET. 
The SET key is located above the "5" key. 


2) Release SHIFT and press the blank red key. This key 
is to the right of the SET Key. 


3) Now press the grey key marked ERASE PAGE. This key is 
the top left of the cluster of grey keys to the right 
of the typewriter keyboard. The screen will be filled 
with red. | 


If the screen is not uniformly red (the red may tend toward 
green or purple in some areas), the 7989 should be degaussed. 


To degauss the screen, press the DE-GAUSS button. After 
pressing the button, degaussing proceeds automatically for 
several seconds. Colors on the screen will shimmer for a 
moment as the degaussing is performed. 


NOTE: 


You must wait at least 15 minutes after turning on 
the 7999 before degaussing will function. Once 
degaussing is complete, it may not be restarted for. 
15 minutes. If you press the switch again before 
15 minutes have elapsed, nothing happens and you 
must wait another 15 minutes before trying again. 


It is generally necessary to degauss the screen after moving 
the 7999, even if it has been moved across a room. A weekly 
degaussing is also beneficial. 
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Before converging the 7998, perform degaussing first. 
Then proceed with the steps below. 


Below the DE-GAUSS button, there are nine groups of 
three small potentiometers (variable resistors; they look 
like set screws). These are the convergence adjustments. 
Each "pot" adjusts either red, green or blue, and each group 
adjusts one of nine sectors of the screen. For example, the 
upper left group adjusts convergence for the upper left 
corner of the screen. 


NOTE: 


Use a small screwdriver (a jeweler's screwdriver 
is ideal) and BE GENTLE when adjusting convergence. 
The "pots" are fragile. 


Wait at least 15 minutes after turning on the 7906 
to perform convergence, since it may drift until 
the 7999 is completely warmed up. 


To set up a test pattern for convergence, perform the 
following steps: 


1) Press the key marked SOFT BOOT. This key is next to 
the red RESET key at the upper left corner of the 
keyboard. 


2) Press the key marked TEST. This key is adjacent to 
the SOFT BOOT key. Now press the period (.) key. 


This produces a pattern of white dots on a black background. 
Beginning with the center group, turn the screws until 
the dots in the center of the screen are solid white (with no 


colored fringes). Proceed to the other eight groups 
according to the numbers in the following diagram. 
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Chapter 2 -- The Overlay 


The Overlay screen is a powerful feature of the 7999. It was 
designed to relieve the high-resolution Bitmap screen from 
time-consuming operations associated with text manipulation. The 
Overlay provides an area where messages to and from the operator 
may be displayed. It is compatible with several menu selection 
techniques, including the Light Pen and the Bezel Keys. 


The Overlay also provides an environment which is isolated 
from the Bitmap screen, so drawings in the Bitmap will not be 
obliterated by prompts or error messages in the Overlay. 


As an illustration, imagine the Overlay as being a screen in 
FRONT of the high-resolution Bitmap screen. The Overlay is 
Organized as a set of character cells, arranged 85 horizontally 
and 48 vertically. 


Fach cell of the Overlay has the following attributes: 


@ Foreground Color (Foreground and Background color 
@e Background Color may be selected by any color key) 
@ Foreground Blink (on or off) 


e Foreground Transparency 
e Background Transparency 
@® Hardware cursor (available at each cell) 


All 96 standard ASCII characters are available in the Overlay. 
The 32 control characters defined in ASCII may also be displayed, 
in "Visible Control~-Character" mode. An additional set of 128 
Characters is available, and may be selected with the "Select 
Character Set" command, described in section l. This set 
contains Greek characters and other special symbols. 


All characters in the Overlay are formed from a 6 by 8 dot 
matrix. The ASCII character set falls into a 5 x 7 grid within 
this matrix. 


A low resolution plotting mode is available in the Overlay, 
which allows any cell to display a group of eight pixels, two 
horizontally and four vertically. This provides a plotting 
Capability which, in the Overlay alone, exceeds the resolution 
available on many other computers! The resolution of the Overlay 
plot mode is 17@ (horizontal) by 192 (vertical). Some of the 
plotting features of the Bitmap screen are also available in the 
Overlay, such as drawing vectors. 


Version 1.4 Page 2-1 


Overlay Defaults 7988 Operator's Manual | Chapter 2 


Overlay Defaults 


When the system is powered up, or when the BOOT or SOFT 
BOOT keys are struck, the Overlay is initialized with certain 
attributes as follows: 


@® Background Black 
@® Foreground White 


e Cursor visible in upper left corner ("home" 
position) 


e Visible (not transparent) Foreground and 
Background 


SOFT BOOT and BOOT do not affect the high-resolution Bitmap 
screen. However, Since the Overlay is not transparent at 
this time, any picture on the Bitmap screen will not be 
visible (see “Modify Overlay Visible Attributes"). If the 
system has just been powered up, no picture will be present 
on the Bitmap screen anyway. 
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Overlay Operations 

When the system is initially powered up, or booted, you 
will be addressing the Overlay. This section discusses the 
types of commands accepted by the Overlay. 

The Overlay is designed for easy communication with a 
host computer or other remote device. Its main purpose is to 
display alphanumerics; it can do this much faster than the 
Bitmap. Most messages to and from the operator will be 
displayed in the Overlay. For this reason, the Overlay is 
the default mode of operation when BOOT is executed. 

When you are addressing the Overlay, the OVERLAY key 
will be lighted. Note that this light is on when the system 
1s booted. When this key is extinguished, you are addressing 
the Bitmap, which is discussed in later sections. 

Entering and Exiting the Overlay 


If you are addressing the Overlay, and want to address 
the Bitmap, press: 


SHIFT OVERLAY 


Hold the SHIFT key and press the lighted key marked OVERLAY. 
The light wilI go out. 


When you want to talk to the Overlay again, press 
OVERLAY 
The OVERLAY key produces the following code: 
MODE O l 
MODE V 3 
SHIFT OVERLAY produces the following code: 
MODE O @ 
MODE V @ 
The MODE O command tells the 7988 whether the Overlay or 


Bitmap is to be addressed. The MODE V command is discussed 
later in this chapter. 
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Overlay Cursor Control 


The Overlay cursor is a flashing white overscore and 
underscore. It is initially located in the upper left corner 
of the window, which is termed its "home" position. Pressing 
the HOME key on the cursor keypad will always return the 
cursor to this position. 


Two keys on the typewriter section of the keyboard have 
an effect on the cursor. RETURN (carriage return) moves the 
cursor to the beginning of the current line. LF (line feed) 
moves the cursor down one line. 


Tab stops are located every four character cells in the 
Overlay. Pressing the CTRL modifier with the I key will 
generate a Tab character, and will move the cursor to the 
next tab stop. 


CTRL I 


The other keys on the cursor keypad are used to position the 
cursor in the Overlay, and to perform text editing functions: 


e The four arrow keys move the cursor in their 
respective directions. Simultaneously pressing two 
adjacent arrow keys moves the cursor diagonally.. 


@e HOME moves the cursor to the upper left corner of the 
window. CTRL HOME moves the cursor to the LOWER left 
corner of the window ("home lower"). 


@ ERASE PAGE clears the Overlay window to whatever 
| background color is in effect (initially black). 


e CLEAR LINE erases the line at which the cursor is 
currently positioned. 


@e The RECALL key is only active when you are entering 
input to the Disk Operating System, the Monitor, or 
some other controlling program. See the description 
of INLINE (the Inline Editor), in Appendix C. 
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The functions labelled in blue on the front of the 
cursor control keys are also text editing features. They are 
accessed by holding down the CTRL modifier and pressing the 
required key. | 


e ERASE EOS erases from the current cursor position to 
the end of the screen (the current window). 


e CLEAR EOL clears from the current cursor position to 
the end of the same line. 


e DEL LINE deletes the line at which the cursor is 
positioned. All lines below this one move up to fill 
in the gap. 

e DEL CHAR deletes one character at the current cursor 
position. All characters to the right of the deleted 
character move left one position. 

e INS CHAR moves all characters to the right of the 
cursor, one poSition to the right. One character may 
now be inserted in the gap. 


e INS LINE moves all lines below the cursor, down one 
line. One line may now be inserted in the gap. 


Several other commands are involved with the cursor: 


CURSOR ON turns the cursor on, while uSing the SHIFT 
modifier with CURSOR ON turns the cursor off. 


MOVE X-Y positions the cursor absolutely. 
Format: 
MOVE X~-Y¥ <X>,<Y>, 
Where: 
<X> is a decimal number between @ and 84 
<Y> is between @ and 47 
The cursor is moved immediately to the required coordinates. 
The coordinate system is arranged with @, @ in the upper left 


corner. xX increases from left to right. Y increases going 
down. 
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It is possible, using MOVE X-Y, to move the cursor 
outside the limits of the current window. Pressing HOME will 
bring it back inside the window. 


The following command moves the cursor relative to its 
current screen location. 


Format: 
MODE m <dX>, <dyY>, 
Where: 


<dX> and <dY> are each decimal numbers, followed 
by a comma. 


The parameters <dX> and <dY> are added to the current cursor. 
position. Note that a lower case m must be entered, and this 
may require use of the SHIFT key (depending on the state of 
ALPHA LOCK). 


Overlay Cursor Blink ON/OFF 
Formats: 
ESC q <@ or I> 
NOTE: 
This command requires entering a lower’ case 
letter, q. If the ALPHA LOCK key is in its normal 


(up) position, it iS necessary to use the SHIFT key 
with the "Q" key to produce a lower case q. 


The character @ disables Overlay cursor blink, and the 
character 1 enables it (the default condition). If more than 
one Overlay cursor is in use, all are affected by this 
command: all Overlay cursors will blink, or none of them 
will. 
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Overlay Roll and Page 


The Overlay defaults to Page operation. In Page, no 
lines of the window are ever moved. When the last line of 
the window is completed, the cursor moves to the first line 
of the window. If additional text is entered, it will 
overwrite the first lines of the window. Page is primarily 
useful for plotting applications, where it is imperative that 
output be fixed at a particular screen location. 


In Roll, as the last line in the window is completed, 
the cursor remains on that line. The first line in the 
window is "rolled" off the top of the window, and is lost. 
All other lines in the window move up one line. Roll is 
Standard for computer terminal applications. 


To enter Roll, press the ROLL key: 
ROLL 


The light in the ROLL key will illuminate. The window is in 
Roll. | 


To leave Roll and return to Page, press 
SHIFT ROLL 
The ROLL key will extinguish. The window is back in Page. 
Remember that each window has an Overlay part and a 
Bitmap part, and that the Roll command affects a window. 
This means that if a window is in Roll operation, both its 
Overlay and Bitmap parts are in Roll. If your application 


requires Overlay to be in Roll, and simultaneously requires 
that Bitmap be in Page, then you have two options: 


1. Always transmit the Roll On/Off code whenever 
you move between Overlay and Bitmap 


2. Use two windows, and leave one in Roll and one 
in Page. 
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Overlay Color and Blink 


Each cell of the Overlay has a foreground and a 
background color. The available colors are the eight color 
keys on the keyboard, black through white. Additionally, 
each cell may be specified to blink. If blink is on, the 
character in the cell will blink from its normal foreground 
color to the background color of the same cell. 


Each cell may also be transparent, in foreground or 
background or both. If part of a cell is transparent, the 
image in Bitmap may be seen behind the Overlay image. See 
"Modify Overlay Attributes" for details. | 


All of the commands in this section affect the future 
contents of the Overlay. The present color and blink 
attributes of the Overlay are unaffected by SET or BLINK 
commands. You must remember to specify color and blink 
before entering information into the Overlay. 


NOTE: 


Only the foreground color is allowed to blink in 
the Overlay. The foreground color will toggle 
between its normal color and the current background 
color. The background color of the character cell 
will never blink. | 
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Set Foreground Color 
Format: 
SET <color> 


<color> may be any one of the eight color keys. The Overlay 
foreground color is now set to the same color as the key. 


Alternatively, a color number may be specified. Color 
numbers through 7 in the Overlay correspond to the eight 
color keys, black through white. This form would most often 
be used from a host computer. 


Alternate format: 
SET <n>, 


<n> is the color number, and must be terminated by a comma. 
The eight color keys correspond to the following color 
numbers: 


Color Key Color Number 


Black 
Blue 
Green 
Cyan 
Red 
Magenta 
Yellow. 
White 


SHA OI WDE @& 


Example: 
SET 7, Set foreground to white (default) 


These eight colors are the. only colors available in the 
Overlay. These colors remain available in the Overlay, 
regardless of the color configuration of the Bitmap. (The 
Bitmap allows a selection from over 16 million colors. It is 
discussed in Chapter 8.) 
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Set Background Color 
Format: 
SHIFT SET <color> 


Hold down the SHIFT modifier while striking the SET key to 
set background color. Foreground color is not affected. 


As above, a color number may be used instead of a color key: 


SHIFT SET <n>, 


Overlay Blink ON 
Formats: 
BLINK 


The BLINK key will light up. The blink attribute is now on. 
Any characters now entered into the Overlay will have a 
blinking foreground. (Overlay background color cannot 
blink.) 


Overlay Blink OFF 
Formats: 


SHIFT BLINK 


Holding down the SHIFT modifier while pressing the BLINK key 
will turn off the blink attribute. The light in the BLINK 
key will go out. Future characters entered into the Overlay 
will have a non-blinking fa@eground color. This is the 
default condition. 
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Modify Overlay Visible Attributes 


Formats: 


MODE V <n> Modify Present Attributes 


MODE v <n> Modify Future Attributes 


Where <n> is interpreted as follows: 

®@ Foreground and Background Transparent 

1 Foreground Transparent (Visible Background) 

2 Background Transparent (Visible Foreground) 

3 Foreground and Background Visible 

Modify Present Attributes will immediately cause the entire 
window to assume the attributes set by <n>. 

e If <n>=0, the window will immediately become totally 
transparent (except for the Overlay cursor, if it is 
currently visible). The Bitmap image will be fully 
visible. 

e If <n>=l, the entire window will assume a visible 
background, transparent foreground condition. The 
Bitmap screen will only be visible through the 
characters in the Overlay window. 

e If <n>=2, the entire window will assume a visible 
foreground, transparent background condition. The 
Bitmap screen will be visible everywhere except where 
Characters exist in the Overlay. This condition is 
useful for superimposing titles (in the Overlay) onto 
pictures (in Bitmap). 

e If =<n>=3, the entire window will be visible 
. (foreground and background) and no Bitmap image will 
be seen through the window. Only Overlay material 
will be visible. This is the default condition at 
power-up. 

Example: 


MODE V 2 will cause lettering in the window to be 


visible over a picture in Bitmap. 


MODE V 3 will cause the window to be entirely visible 
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(non-transparent). This is the default 
condition when the system is booted or reset. 
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Modify Future Attributes will cause no immediate change 
in the Overlay window. However, any further characters sent 
to that window will be affected by the command. The 
interpretation of <n> is basically the same as above: 


e If <n>=@, future characters sent to the window will 
not be visible at all. 


e If <n>=1, future characters sent to the window will 
have a visible background and transparent foreground. 


@e If <n>=2, future characters sent to the window will 
have a transparent background and visible foreground, 
and will be superimposed over the image in Bitmap. 


@ If <n>=3, future characters sent to the window will 
have a visible foreground and background, and will 
completely block out the Bitmap image where they 
appear. 


Example: 


MODE v @ will inhibit all characters sent into the 
Overlay window from being seen. 


MODE v 2 will cause characters sent into the Overlay 
| window to be superimposed over the image in 
Bitmap. 


If a character in the Overlay has been specified to blink, 
and has visible foreground and transparent background, that 
character will blink from visible to transparent. For 
example, an important part of a drawing (in the Bitmap) could 
be labelled by lettering (in the Overlay) and if the 
lettering was specified to blink, the drawing could be. seen 
in full whenever the characters blinked to transparent. (AI1l 
7960 blink functions occur at a rate of 1.9 Hertz, with a 50% 
duty cycle. This means a letter will be visible for 9.26 
seconds and transparent for the next 9.26 seconds.) 
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Overlay Plotting Functions 


Overlay plotting functions are extensions of plotting 
features available in the Bitmap. Each of the Plot Submodes 
is discussed in detail in Section 9. If you are not familiar 
with Bitmap plotting features, please read Sections 8 and 9 
before attempting to use the Overlay for plotting. 


The Overlay can produce many of the same kinds of 
figures available in the high-resolution Bitmap. All Plot 
Submodes operate in the Overlay (see Chapter 9). The Overlay 
resolution is 1798 by 192 (as opposed to 1924 by 768 in the 
Bitmap). 


Plotting in the Overlay works much like Bitmap plotting. 
Here are the differences: 


@e Scale factors are not allowed. All coordinate data 
should be entered as numbers between @ and 169 for X, 
and @ to 191 for Y. 


e The cursor position may not be used to enter 
coordinates using the decimal point. 


e The Overlay handles primitive filled figures. The 
optional Complex Area Fill and Edge Fill routines will 
not work, however. 


@ Pixels in the Overlay are 3 x 2, compared to 1 x l 
Square pixels in the Bitmap. This causes circles to 
come out as ovals. 


All currently defined foreground attributes are applied to 
the plotted figure, including transparency. You can plot a 
"transparent" figure and view the Bitmap through = an 
irregularly shaped area. 


Plotting in the Overlay is slow, and it is easy to 
accidentally switch to the Overlay from the Bitmap and end up 
drawing a large figure, say, a circle with a 59@9-pixel 
radius. This circle would wrap around, enveloping the 
Overlay; while the figure is being drawn, the system would 
appear to hang. 


NOTE: 


If the MODE V command is used to change the 
background visibility, a filled area may change. 
This is intentional and is required to _ allow 
multiple colored lines to be drawn at full 
resolution. Filled areas are filled using 
background character cells. 
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Chapter 3 ~-- System Commands 


This section describes commands which affect the entire 
system. Unlike Mode or Plot commands (described in following 
chapters), these commands by themselves do not immediately change 
anything on the screen. Commands covered in this’ chapter 
include: 


e Assign Devices 

e Select Character Set 
@ Delay 

e Function Keys 

e Light Pen 

@ Real-Time Clock 

e Test Mode 

e Tone Generator 

@® Visible Control Characters 
e Warmstart 

e Windows 

e Scaling 


@e Hardcopy 
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Assigning Physical Devices 


Assign Output Device 
Formats: 
ASSIGN OUTPUT <n> <dev> <dev> <dev> <dev> 


Where: 


<n> is the Logical Device number (@ through 3) 


<dev> is the letter corresponding to a physical 
device (see table 3-1) 


Each Logical Output Device may access up to four physical 
devices. This allows transmitting commands to more than one 
window, or sending to a window and a peripheral device 
Simultaneously. 


All four physical devices must be specified. If less 
than four are required, you must enter dummy devices using 
the character Z. 


Examples: 
ASSIGN OUTPUT 1AB ZZ 


Logical Output Device number 1 has been connected to 
physical devices A and B (the first two windows). Two dummy 
devices are used. 


ASSIGN OUTPUT @ A K ZZ 


Logical Output Device 9 has been connected to physical 
device A (the first window), and the keyboard lights (see 
below). No other physical devices are connected to Logical 
Output Device @. This is the default condition. 


Physical Output Device K is the keyboard lights. The 
keyboard handler interprets all codes it receives, and 
decides which lights should be on or off. For example, when 
the FILL key is pressed, the "Fill" attribute is turned on. 
The keyboard recognizes the code sequence produced by the 
FILL key and turns on the light in that key. 
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It is possible to assign other Logical Output Devices to 
the keyboard lights, or to arrange the assignments so that 
the keyboard lights receive no information at all. If this 
is done, the keyboard lights may not reflect the current 
state of the system. 


Example: 
ASSIGN OUTPUT @ A KT Z 


Logical Output Device 9 has been connected to window A, to. 
the keyboard lights (K), and to the tone generator (T). 

Physical output device T is a special configuration of the 

tone generator. When assigned in this manner, it will sound 

a “click" every time a key is pressed. Some users appreciate 

this feedback, especially if they are not used to typing on a 

computer keyboard. We have maintained a connection to the 

keyboard lights in this assignment. 


The ASSIGN OUTPUT command can be used to change both the 
Current window and the current Logical Device. For example, 


ASSIGN OUTPUT 1 BK ZZ 


makes window B the current window and changes the output to 
Logical Device l. To return to Logical Device 9, send 
another Assign Output command. 


Under Idris, change to a different Logical Device by 
typing: 

Ml M2 <num> 
Where <num> is @ through 3, corresponding to a Logical 
Device number. This avoids having to remember which Physical 
Devices are associated with each Logical Device. 


Example: 


ASSIGN OUTPUT @ A K ZZ (Logical Device 9 -> Window A) 
WINDOW @,9, 511,383, (Window A is upper left corner) 
ASSIGN OUTPUT 1 BK @ @ (Logical Device 1 -> Window B) 
WINDOW 511,898, 18923 ,383, (Window B iS upper right corner) 


ASSIGN OUTPUT 2 C K Z Z (Logical Device 2 -> Window C) 
WINDOW 9,383, 1923,767, (Window C is bottom half of screen) 


Ml M2 Q (Send output to Window A) 
na (Commands to Window A) 
Ml M2 2 (Send output to Window C) 
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Assigning Input Devices 
Formats: | 
ASSIGN INPUT <n> <dev> 


Input devices are assigned using the SHIFT modifier with the 
ASSIGN key. Only one physical input device is assigned to a 
Logical Input Device. 


WARNING : 


Logical Input Device @ is normally assigned to the 
keyboard. Most programs will read from Logical 
Input Device @ to receive their input. If you 
connect Logical Input Device 9 to another physical 
device, or to a dummy device, the system could 
hang. Recovery will only be possible via RESET. 


This can be useful for disabling the keyboard while under 
control of a host ' system. RESET, however, will still 
function. 
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Table 3-1. Physical Device Assignment List 


OUTPUT DEVICES 


window 
window 
window 
window 
window 
window 
window 
window 


moO WMOdQW YP 
TO VMMONW YP 


A 


keyboard lights 


RS-232 serial port 
RS-449 serial port 


yu 2tt 


parallel port 


Serial Port Controller port #1 
Serial Port Controller port #2 
Tone Generator (if SPC is not installed) 
Serial Port Controller port #3 
Serial Port Controller port #4 


<—G Wh 


Z dummy 


INPUT DEVICES 


A 


keyboard 


RS-232 serial port 
RS-449 serial port 


= 


parallel port 


Serial Port Controller port #l 
Serial Port Controller port #2 
Serial Port Controller port #3 
Serial Port Controller port #4 


<CHMN tg 


N 


dummy 
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Select Character Set 


Two character sets are supplied in the 7900. The 
standard character set contains 96 printable ASCII 
characters, plus 32 visible control characters. The standard 
character set is selected by default when the system is 
booted. 


Format: 


CTRL O ("A7 off" -— standard character set) 
CTRL N ("A7 on" - alternate character set) 


The alternate character set is called the "A7" set. It 
contains graphics figures, Greek characters, and other 
Special symbols. It may be selected at any time by pressing 
CTRL N (hold down the CTRL key and press N). Only the window 
which receives the command will switch to the alternate 
character set. 


To return to the standard character set, hold down the 
CTRL key and press O. : 


The altemate character set iS available in both Overlay 
and Bitmap. See Appendix F for the available character 
fonts. Note that the Overlay also has a Plot Dot capability, 
and this is not related to the character fonts. Plot dots 
are used for Overlay plotting features. 
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Delay 
Format: 
ESC D <n>, 


Where: 


<n> is the number of 6@ths of a second to delay; 
-l <n < 32767. 


Delay is often used in conjunction with pictures drawn in 
the Create Buffer (see Chapter 5). Delay allows time for a 
user to examine a drawing or read text. Delays may be 
specified to the nearest 6@th of a second. 


Example: 
ESC D 120, Delay two seconds 


If <n> is -l, the system will wait until a key is pressed on 
the keyboard: 


ESC D -l, Delay until a key is pressed 
ESC D @, Wait for next vertical retrace. 


NOTE: 


The Delay command polls the vertical retrace bit. 
If the processor is interrupting on vertical 
retrace (e.g., while running Idris), the delay time 
may be inaccurate. Also, the keyboard wait 
function assumes that the 79998 firmware has control 
of the keyboard interrupt vector (not true while 
running Idris). The system may hang if the vector 
was used earlier by another program. Therefore, do 
not use this command with Idris. 
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Function Keys 
Format: 
DEFINE <Fn> <command sequence> <Fn> 


Where: 


<Fn> is a function key, Fl through 
F24 


<command sequence> is any set of characters and/or 
commands 


The twenty-four function keys, Fl through F24, are 
user-definable. You may program these keys to perform any 
sequence of commands, and once programmed, the keys will 
remember their definitions until the definitions are changed. 
If your system is equipped with battery-powered CMOS memory 
(optional), then the user-defined keys will remain defined 
even while system power is off. 


The function keys F13 through F24 are accessed by 
holding down the SHIFT key while pressing the appropriate 
function key. Thus, 


SHIFT Fl 
is the same as 
F13 


To define a function key, press DEFINE, followed by the 
function key you wish to define. To program the Fl key, type 


DEFINE Fl 


The light on top of the function key will come on to remind 
you that a function key is being defined. Then type any 
sequence of commands or characters. The keys you press will 
not have any effect on the display, but they will each be 
acknowledged by a “hissing" sound from the speaker. 


NOTE: 
The function key lights will NOT come on while any 


of F13-F24 are being defined; however, the speaker 
will still hiss during the definition. 
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When you have typed all the keystrokes you wish to enter 
into this function key definition, hit the function key again 
(the same key you started with). This will be acknowledged 
by a "gong" sound from the speaker, and the function key 
definition is now complete. Pressing the same function key 
at any future time will produce the stream of characters (or 
commands) which you entered as the definition. 


Example to define function key Fl: 

DEFINE Fl T H I S SPACE I S SPACE A SPACE TEST Fl 
Example to define function key F24: 

DEFINE F24 12345678 9 @ F24 
Note that to CLOSE the definition of F24, you must be sure 


to hold down the SHIFT key at the end of the definition. 


This is because a function key is allowed to "call" other 
function keys: 


DEFINE F2 Fl Fl Fl Fl F2 


Pressing F2 is now equivalent to pressing Fl four times. 


storage for function key definitions is dynamically 
allocated. A key will use only as much space as it needs. 
This means the available storage may be used all by one key, 
Spread evenly among many keys, or distributed in any other 
way. The default function key buffer allocation is 768 
bytes, in CMOS (if present) or in static RAM. The "Thaw" 
command may be used to alter this allocation. 


If function key storage overflows while defining a key, 
the normal "“gong" sound for closing the definition is 
produced, and no more characters are accepted. It is then 
necessary to "un-define" some keys (define them to be null) 
to provide space for future definitions. Since definitions 
are stored in battery-powered CMOS memory (if installed), it 
is possible for function key definitions to remain in the 
system long after their usefulness has ended. 


Example to delete the definition for Fl: 


DEFINE Fl Fl 
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Bezel Keys 
Eight bezel keys are located on the bottom of the frame 
Surrounding the 7988 screen. They are defined and used in 
the same way as the function keys described above. 
Formats: 
DEFINE <bezel> <command sequence> <bezel> 
Where: 


<bezel> is any one of the eight bezel keys 


<command sequence> is any stream oof characters or 
commands 


See the previous section for more information on 
user-defined keys. The SHIFT key may not be used with bezel 
keys to generate unique codes. If SHIFT is depressed while 
pressing a bezel key, it is ignored. 


Overflows are handled the same way for bezel keys as for 
the other function keys. 


The bezel keys have an additional use when debugging 


assembly language programs. See Appendix C_ for a 
description. | 
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Defining Function Keys from a Host 


Obviously, a host computer or a controlling program 
cannot push buttons to define function keys. There are three 
ways, however, that the function keys can be modified without 
touching the keyboard: 


® Directly load the entire Function Key buffer. 
The function keys normally reside in CMOS RAM 
from hex address SE4998@0 to SE4QBFF. These 
boundaries can be changed with Thaw (see 
Chapter 6). Note that this method loads all 32 
function keys, wiping out any old definitions. 


9 From a program running under Idris, individual 
function keys can be modified using drivers 
/dev/fkeyl through /dev/fkey32. The driver 
/dev/fkeys accesses the entire buffer. 


e Use USER J and USER j commands to define 
individual function keys from a host’ or 
internal program. This is the easiest method 
to use from a host, and is discussed below. 


To define a function key from a host or internal program, 
the proper input port must be assigned as the primary input 
device rather than the keyboard. Assuming your host is 
connected to the RS-232 port, the proper command would be: 
ASSIGN INPUT @L 
- OR - 
USER I@L 


This code can be sent from the host or the keyboard. 


The function keys can now be defined. Assuming that Fl 
is the desired key, the following sequence will define it: 


USER j (Code for the DEFINE Key) 
USER JA (Code for function key Fl) 
<command sequence> 
USER JA (Close the definition) 
If you do this from the keyboard (get out of Idris or DOS 
first), you will see Fl light up after you type USER JA the 


first time. The system will "bong" as usual and turn off the 
function key light after the second USER JA is sent. 


_ 
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After defining the function keys, reconnect the keyboard 
with the following code: 


USER I@K 


Function keys can be "nested" in this manner, also: 


USER j (Code for DEFINE) 
USER JB (Code for function key F2) 
USER JA USER JA (Enter Fl twice) 


USER JB (Close F2) 


Now, pressing F2 will have the same effect as pressing Fl 
twice. 


To execute function key Fl, simply send USER JA. Codes 
for the other keys are shown below. 


Key Char Key Char 

Fl A F19 S 

F2 B F296 Au 

F3 Cc F21 U 

FA4 D F22 V 

F5 E F23 W 

F6 F F24 X 

F7 G 

F8 H Bezel 1 — (underline) 
F9 I Bezel 2 * (accent grave) 
F1@ J Bezel 3 ] 

F1l K Bezel 4 7 

F12 L Bezel 5 [ 

F13 M Bezel 6 \ 

F14 N Bezel 7 Y 

F15 O Bezel 8 Z 

F16 P 

F17 Q 

F18 R 


For example, USER JI corresponds to function key F9. 
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Light Pen 


The (optional) light pen is housed on the right side of 
the CGC 7999 display behind the tall, thin door. It is held 
in place by a clip behind the door. While the light pen is 
in use, the clip can be used to hold the pen in a convenient 
position. 


To use the pen, hold its barrel in your right hand, and 
touch the pen's tip with your index finger. The finger makes 
electrical contact across the black insulating ring, and 
causes an interrupt in the 7998 system. Aim the pen at the 
screen, holding it at a right angle to the screen and about 
one inch away. 


To enable the pen, use the following command: 
USER | <f1> <£2> <n> 

Where: 
<f1> and <f£2> are single characters, A through Z 
<n> is a Single digit, 9 through 4 (see below) 


The character | is located on the same key with the 
backslash, \. 


<fl> and <f£2> are specifiers which indicate function 
keys to execute, before and after the light pen hit. The 
characters A through X are used to designate function keys Fl 
through F24 (see page 3-12). Enter a character outside this 
range to disable either or both of the function keys. 


<n> is a flag which determines the state of the light pen: 


<n> Function 
4) Disable light pen. 
1 Enable light pen, using Bitmap coordinates, 


with blue flood. 


2 Enable light pen, using Bitmap coordinates, 
without blue flood. 


3 Enable light pen, using Overlay coordinates, 
with blue flood. 


4 Enable light pen, using Overlay coordinates, 
without blue flood. | 


Blue flood occurs only in areas of the Overlay which are 


defined to be "foreground visible." See "Modify Overlay 
Visible Attributes" (in Chapter 2). If blue flood is 
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disabled, only bright blue or white areas of the screen will 
be recognized by the light pen. 


. Examples: 


DEFINE Fl INC VECTOR Fl Define key Fl to be a 
Incremental Vector command. The 
INC VECTOR key is directly below 
function key F1@; you have to 
hold down the SHIFT key while 
- pressing INC VECTOR. 


DEFINE F2 @CC@@cc@ F2 Define F2 to hold arguments to 
| Incremental Vector. 


USER | AB 1l Activate light pen with function 
keys A (Fl) and B (F2), use 
Bitmap coordinates, and enable 
blue flood. 


SHIFT OVERLAY Send the results to the Bitmap. 


Now, each time the light pen is detected on the screen, a 
small rectangle will be drawn. 


Note that the light pen produces coordinates from 9 to 
1923, if <n> is 1 or 2; it produces coordinates from 8 to 84 
if <n> is 3 or 4. In either case, the Overlay foreground 
must be visible if blue flood is desired. The command MODE V 
2 will make the Overlay window have a visible foreground. 


Other examples: 
USER | 988 Disable the pen. 
USER | 0@1 Enable the pen to simply output coordinates 
each time a hit is detected. This is useful 


for "freehand" drawings (using Concatenated 
Vectors). 
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Real-Time Clock 
The Real-Time Clock (optional) keeps track ‘of months, 
days, the day of the week, hours, minutes, seconds, and 
fractions of seconds. Several commands are provided to set 
and display the time and date information. 
Set Clock 
Format: 
USER q MM DD N hh mm, 
Wheres 
MM is the two-digit month code (81 through 12) 
DD is the two-digit day code (@1 through 31) 
N is the day-of-week code (1=Sunday through 7=Saturday) 
hh is the two-digit hours code (@@ through 23) 


mm is the two-digit minutes code (@@ through 59) 


NOTE: 


This command requires entry of a lower case 
letter, q. If the ALPHA LOCK key is in its normal 
(up) position, you must use the SHIFT modifier with 
the "Q" key to produce a lower case q. 


All of the above parameters are set simultaneously, by a 
Single entry to the Real-Time Clock. It is not possible to 
set the parameters individually. 


Either a comma or semicolon may be used to terminate 
this command. 
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Examples: 
USER q 8919119235, (January 1, Sunday, 2:35 AM) 
USER q 112141745, (November 21, Wednesday, 5:45 PM) 


When setting the clock to an exact time, use the following 
procedure: Enter the date and time information as above. 
Enter the minutes as being ore or two minutes ahead of exact 
time. Wait until the time you entered equals the exact time, 


THEN enter the comma. 


NOTE: 


Entering too many characters without the delimiter 
can cause a stack overflow. 


Display Time 
Format: 
USER Q <@ or 1> 


Use the character 1 to enable the time display, or 8 to 
disable it. 


This commad causes time and date information to be 
continuously displayed in the upper right corner of the 
Overlay. The information is updated once per second. 


Entering a @ prevents the displayed time from being 
updated, but does not remove the last displayed time from the 
Overlay screen. It is necessary to erase the Overlay, or 
make it transparent, to completely remove the clock display. 


NOTE: 


If your system is not equipped with the Real-Time 
Clock option, this command will cause the system to 
hang. Press RESET to recover. 


This function will work under Idris, but the last 
digit will sometimes be obscured by the disk access 
indicator. 
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Test 


Format: 
TEST <character> 
Where <character> is any displayable character. 


The TEST command will fill the window in use with the 
specified character. TEST is available in both Overlay and 
Bitmap. Whichever window is currently being addressed will 
be filled with the character. (Either the Overlay window OR 
the Bitmap window -- not both -- will be filled with the 
character.) 


In the Overlay, all currently defined attributes will be 
applied to the test character. This includes foreground and 
background color, foreground and background transparency, and 
blink. 


In the Bitmap, the currently defined attributes will 
also be applied. Remember that these attributes may not be 
the same as the currently defined attributes of the Overlay. 
The currently defined foreground and background colors, 
blink, and character size, will be applied to the test 
character. 


Following completion of the TEST function, the cursor 
will be placed in the "home" position of the window. 
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Tone Generator 
Format: 
* TONE <A>,<B>,<C>,<L>, 


Where: 


<A> ,<B>,<C> are the frequencies (in hertz) of 
each of the three voices from the 
tone generator. 


<L> is - the tone duration (in 
milliseconds). 


The TONE command is located on the same key as TEST. Typing 
SHIFT TEST begins the Tone command. 


The tone generator 1S programmable from the keyboard. 
You may program the frequency of each of the three voices and 
the duration of the tone. When programming from the 
keyboard, the envelope is fixed and causes the amplitude to 
decay steadily over the duration of the tone. 


NOTE : 


The QUIET LOCK key on the keyboard must be in its 
normal (up) position, or the speaker is disabled 
and no tones can come out! 


The tone generator can produce tones covering nearly the 
entire audible range. The range of useful values for <A>, 
<B> and <C> is from 38 to 15000 (hertz). 


NOTE: 


Selecting a frequency of @ on any channel turns 
that channel off. 


The duration of the tone may be set to any value up to 
approximately 9399 (milliseconds). This would produce a tone 
9.3 seconds long. 


Page 3-18 Version 1.4 


Chapter 3 7968 Operator's Manual Tone Generator 


Example: (to select voice A to be “middle A" on the piano, 
or 4490 Hz) 


<A> = 449 
If we want voice B to be one octave higher, then let <B> = 
88a. Then, we could let voice C could be one octave above 
that, which would make <C> = 176@. 


Finally, select a duration of 1 second. Then <L> = 1000. 
‘Our finished command then becomes: 


TONE 449 ,880,1760,10090, 
The following list showS approximate frequencies’ for 


different notes. Some of them may be slightly "out of tune" 
because of roundoff error. 


Note Freq. Note Freq. Note Freq. Note Freq. 
Cc. 1 33 C.. 3: 1321 Cc. 5 523 C 7 2693 
C# 1 35 C# 3 139 C# 5 554 C# 7 2218 
D i141 37 D 3 =4147 D 5 587 D 7 2349 
D# 1 39 D# 3 156 D# 5 622 D# 7 2489 
E 1 41 E 3 169 E 5 659 E 7 42637 
F ll 44 F 3 175 F 5 699 F 7 2794 
F# 1 46 F# 3 185 FH 5 7486 F# 7 296@ 
G ll 49 G 3 196 G 5 784 G 7 3136 
G# 1 52 G# 3 208 G# 5 831 G# 7 3322 
A 1 55 A 3 2290 A 5 88@ A 7 3529 
A# 1 58 A# 3 233 A# 5 932 A# 7 3729 
B 1 62 B 3 247 B 5 988 B 7 3951 
C 2 65 C 4 262 C 6 1847 C 8 4186 
C# 2 69 C# 4 277 C# 6 1199 C# 8 4435 
D 2 73 D 4 294 D 6 41175 D 8 4698 
D# 2 78 D# 4 311 D# 6 1245 D# 8 4978 
E 2 82 E 4 330 E 6 1319 E 8 5274 
F 2 87 F 4 349 F 6 1397 F 8 5588 
F# 2 93 FH 4 379 F# 6 14890 F# 8 5929 
G 2 98 G 4 392 G 6 1568 G 8 6272 
G# 2 194 G# 4 415 G# 6 1661 G# 8 6645 
A 2 1190 A 4 449 A 6 17686 A 8 764 
A# 2 117 A# 4 466 A# 6 1867 A# 8 7459 

2 124 B 4 494 B 6 1976 B 8 7982 
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Visible Control Characters 


The 79909 has the capacity to make control characters 
visible. Control characters are normally non-printing 
symbols which have an effect on the state of the system, such 
as Break or Return. For debugging purposes, it is sometimes 
useful to observe the characters themselves without letting 
them actually function. 


Formats: 
ESC V <window> <@ or 1> 


Where: 


<window> is the name of the window where visible 
control characters are desired. This will 
usually be the default window, named A. 


<@ or 1> is the character 9 or l. @ turns visible 
control characters off (the default condition) 
and 1 turns them on. 


After visible control characters are turned on, all ASCII 
control characters sent to the window will be displayed in 
abbreviated form. 


Example: 
ESC VA 1 


Visible control characters are now ON in window A. Now, if 
we strike the RETURN key, we see the symbol: 


C 
R 


which is the abbreviation for Carriage Return. Other control 
characters may be displayed in the same way. 


NOTE: 


Escape and User codes will be executed (and not 
displayed) whether Or not visible control 
characters are active. | 


Alternatively, a visible control character can be 
displayed by holding down the Ml and M2 keys and striking a 
control character. This is useful for quickly examining the 
symbol produced by a particular control character. Ml and M2 
will always display a visible control character, regardless 
of whether the ESC V command was given. 
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Example: 
Ml M2 ERASE PAGE 
displays the abbreviation: 


F 
F 


which stands for Form Feed, the standard ASCII erase-page 
code. 


To examine a control character which does not have a 
separate key assigned to it, you must hold the Ml and M2 keys 
and the CTRL modifier, and press the desired key. 


Example: 
Ml M2 CTRL D 
displays 


E 
T 


which is the abbreviation for EOT, or End Of Transmission. 


Note that some keys (especially the labelled keys in the 
upper part of the keyboard) produce several codes for each 
keystroke. This is normal. Appendix A provides a complete 
list of code sequences, and the advanced user will want to 
memorize many of these sequences. 
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Warm Start 


Programs which interact with the user and take over 
control of the 79090 system may be re-entered after an 
interruption, if set up properly. To re-enter an interrupted 
program, execute the Warm Start sequence: 


USER W 


The “warmstart vector" is located at S@C8E (hex), and is 
four bytes long. Programs which use this feature must load 
the warmstart vector with some "“warmstart address" so that 
typing USER W will cause the proper action to occur. 


If a program is in a "runaway" condition, such as a very 
long listing that will not terminate, it is generally 
possible to stop the program by pressing RESET, followed by 
USER W. In a properly designed program, this will interrupt 
the current process but not destroy any data in memory. 


The details of warm-starting a program will depend on 


the program itself. Consult the instructions for the program 
in question. | 
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Windows 


A window is one of the system's primary output devices. 
It may occupy the full screen, or any rectangular subset of 
the screen. Its limits may be defined in the Overlay, or in 
Bitmap. It may have different dimensions in each. 


A window is handled in the same manner as other physical 
devices. When characters or commands are sent to a window, 
it will take some action based on the data it receives (and 
on previous data). For example, if a window receives a "set 
color" command, all future text sent to that window will be 
affected by that command, until another "set color" command 
arrives. 


The system will handle up to eight windows. When the 
system is initialized, only window "A" is assigned, so the 
existence of the other windows is not immediately apparent. 
Other windows are assigned with the "Assign Input" command 
(see page 3-4). Unless otherwise assigned, all primary 
output from the system is directed to window A. 


The 79800 defaults. to four active windows, named A, B, C, 
and D. The number of active windows may be set by Thaw, up 
to eight maximun. 


Window A is termed the master window. In some cases it 
is necessary for the system to reference a Known window, in 
order to properly execute a command. (For example, Pan and 
Zoom make reference to the current cursor position. Since 
each window may have its own cursor, the system must choose a 
particular window. The master window is always chosen in 
these cases.) 


¥ 
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Set Window Limits 


The dimensions of the window you are currently addressing 
may be set with the WINDOW command. 


Format: 
WINDOW <X1>, <Y¥1>, <X2>, <Y2>, 


Where <Xl> and <YIl> are the coordinates of one corner of the 
window, and <X2> and <Y2> are the coordinates of the 
diagonally opposite corner. . 


Following the WINDOW command, the cursor will be moved to 
the "home" position (upper left corner) of the newly defined 
window. | 


An alternate form of the WINDOW command may be used when 
the new dimensions are located inside the previous 
dimensions: 


WINDOW . . 


To use this form of the command, first press the WINDOW key. 
Move the cursor to where one of the corners of the window 
will be. Press the “period" (decimal point) key. Move the 
cursor diagonally opposite to the corner of the desired 
window and press the period key again. The cursor will move 
to its “home"™ position and the limits of the window have now 
been defined. The cursor control keys will not be able to 
move the cursor outside the window limits. Any text written 
into the window will remain inside the established limits. 


Windows may be-.defined and redefined at any time during 
the execution of a user program. Text or figures may be 
created inside a window; then, the limits of the window may 
be redefined so as to protect that text from being. altered. 
Text editing commands, such as ERASE PAGE, will not affect 
areas outside the window to which they are sent. In fact, 
nearly all Mode and Plot code sequences affect only the 
Window to which they are sent. Thus, such attributes as 
color, transparency, plot submodes, blink, fill, character 
size, and many others, are specific to a window. Only the 
window receiving such commands will act upon them. 


Window dimensions are defined differently in Overlay and 
in the Bitmap. A WINDOW command given while addressing the 
Bitmap will define limits only for Bitmap operation. A 
WINDOW command given while addressing the Overlay will define 
limits for the window only in Overlay operation. Thus a 
Single window can have different limits in Overlay and in 
Bitmap. | 
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The possible ranges for window limits are as follows: 


<= 84 


Overlay: @ X 
4) Y <= 47 


<= 1923 


Bitmap: @ <= X 
9 <= Y <= 1923 


Where X is either <Xl> or <X2>, and Y is either <Y1l> or 
<Y2>, in the WINDOW command format shown above. 

One alternate form of the WINDOW command is available to 
reset a window's limits to the maximum size possible. This 


relieves the operator of remembering what the maximum limits 
are for each type of window. 


WINDOW @,09,-1,-1, 


or, SHIFT WINDOW 

This will reset an Overlay window to @, @, 84, 47, or a 
Bitmap window to 9, 9, 1923, 1923, depending on whether you 
are addressing the Overlay or Bitmap. The SHIFT WINDOW 
command may only be used from the keyboard; the other version 
may be used from a host or a program as well. 
Example: (in the Overlay) 

WINDOW @,@,84,23, 
The window size has been set to the upper half of the 
overlay screen. The cursor control keys will not move the 
cursor outside this area. 
Example: (in the Bitmap) 

WINDOW @,0,511,383, 


The window size has been set to the upper left-hand corner 
of the visible Bitmap screen. 


You can easily see the limits of the current window by 
changing the background color and erasing the window to that 
color: | 

SHIFT SET GREEN (set background color to green) 


ERASE PAGE (clear the window to green) 
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NOTE: 


Window restrictions only control the coordinate 
location of cursor movements when used with 
Character operations. Character cells will not 
clip on window edges if forced across an edge with 
a Move Cursor operation. 


On all commands that reference a_ coordinate, 
coordinates are expected to lie within the 
currently scaled limits. If clipping is active, 
the values still should lie within this area but 
may be clipped to a smaller window. 


| Text and graphics can Windows will not 
' be mixed in a window. ! _ interfere with 
| 
| 
| 
| 


i one another. 
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Any window may be used for text. 

Text will not overrun the top windows. 

Windows need not be arranged iike this: they can 
take up as much screen as they need 

and even overlap. 
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Example of CGC 7900 Window Usage 
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Scale Factors (Virtual Coordinates) 
Format: 
SCALE <X1>,<Y¥1>, <X2>,<Y2>, 
Where: 


<X1>,<Y1>, are the desired coordinates of the upper 
| left corner of the window 


<X2>,<Y¥2>, are the desired coordinates of the lower 
right corner 


All numbers must be between -16384 and +16383. 


The SCALE command forces a window to assume a set of 
coordinates. After the command, any coordinates sent to the 
window are scaled according to the coordinates given. SCALE 
is an easy way to adjust the size or aspect ratio of a plot, 
or to plot data which was formatted for a different device. 


NOTE: 


Scaling out of range, or meaningless scaling (such 
as scaling down to one pixel) may produce 
unexpected results. 


Press BOOT before each example in this section to avoid 
interaction between the examples. 


Example: 
BOOT 
SHIFT OVERLAY 
WINDOW 9,9, 1023,767, 
SCALE -1000,1900, 1800,-1000, 


The upper left corner of the window now has coordinates 
-19@0, 10900. The lower right corner of the window now has 
coordinates 1000, -1000. The center of the window now has 
coordinates @, 9. This would be handy for plotting data 
points which are symmetric about the origin. You can easily 
see the effect of this command now by performing some MOVE 
X-Y instructions. MOVE X-Y to @, @ will place the cursor in 
the center of the window, rather than the upper left corner. 
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NOTE: 
In this example we have caused the entire width of 
the screen (10824 pixels) to have a coordinate 
distance of 2000. The entire height of the screen 
(768 pixels) also has a coordinate distance of 
2008. Our coordinate system now does not have a 
square aspect ratio. One unit of travel in the X 


direction is 4/3 as many pixels as one unit of 
travel in the Y direction. 


To overcome this problem, we should make our scaling data 
have the same aspect ratio as the CRT, which is 4 horizontal 
to 3 vertical. 
Example: 

BOOT 

SHIFT OVERLAY 

WINDOW 9,8, 1023,767, 

SCALE -2890,1500, 2000,-1500, 
Now the upper left corner has coordinates -2900, 15908, and 
the lower right corner has coordinates 20098, -1500. The 
coordinate system encompasses 4990 units of X and 3900 units 
of Y, so our aspect ratio iS preserved at 4 to 3 (assuming 
the window is the full screen -- see below.) 

CIRCLE 9,0,19090, 
After giving the SCALE command above, we can draw a circle 
with center 9, 98, and radius 10900, and it fits neatly onto 
the center of the window. 


SCALE can also be used to reflect or mirror-image a 
plot. 


Example: 
BOOT 
SHIFT OVERLAY 
WINDOW 8,0, 1923,767, 


SCALE 1923,767, 0,9, 


Page 3-28 Version 1.4 


Chapter 3 79968 Operator's Manual Scale Factors 


Since the normal coordinates for the upper left corner 
of the screen are 9, 9, and the normal coordinates for the 
lower right corner for the screen are 18923, 767, the above 
example reverses them. Any figure drawn now will be 
reflected about a line from the upper left to lower right. 
It would also be possible to flip only the X coordinate, or 
only the Y coordinate. 


It is important to remember that SCALE causes coordinate 
data to be scaled before it is processed by the window. It 
is as if your program performed scaling and translation 
before sending coordinates to the window. ONLY coordinate 
data are scaled; relative data (such as cursor key movements) 
are unaffected. 


It is possible for different scale factors to be used in 
the X and Y directions. 


Example: 
BOOT 
SHIFT OVERLAY 
WINDOW 9,8, 1923,767, 
SCALE @,0, 19230,767, 


In this case, only one change has been made: the X axis is 
now labelled @ to 19239 instead of @ to 1923. We have 
introduced a scale factor of 18 in the X direction. The Y 
scale factor is unchanged. This kind of scaling can produce 
a problem. Using the scale factors above, suppose we try to 
draw a circle. We supply the center X and Y coordinates and 
the radius, as usual: 


CIRCLE 5119,383, 200, 


The given X coordinate (5118) is adjusted by the current 
scale factor (19) to decide that the X coordinate of the 
Circle's center is at pixel 511. The Y coordinate is 
adjusted similarly, but since its scale factor is 1, the Y 
coordinate remains 383. In "absolute" coordinates then, the 
Circle is centered at 5ll, 383, which is the center of the 
screen, 
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But the radius of the circle must be adjusted by one of 
these scale factors as well. In this situation, where it is 
ambiguous which factor should be used, the X scale factor is 
always chosen. The given radius of 209 is adjusted by the X 
scale factor of 19, and a circle is drawn with a radius of 29 
pixels. 


NOTE: 


Most of the examples in this manual assume that no 
scale factors are in use. You may get quite 
interesting (and unexpected) results if you use the 
SCALE command prior to executing the examples in 
other sections of this manual. 


Extreme scale changes can cause inaccurate 
scaling. | 
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Scaling ON/OFF 
Format: 
MODE S <@ or I1> 


Use the character to disable scaling, or 1 to re-enable 
Lt. 


After establishing scale factors with the SCALE command, 
you can disable scaling with MODE S 9. Later, if you wish, 
you can enable scaling again with MODE Sl. =? 


MODE S 1 will re-enable scaling, using the same factors 
you set up when you gave the SCALE command. Note that SCALE 
automatically turns scaling on when it executes. 


From the keyboard, you may also disable scaling by the 
command 


SHIFT SCALE 
which is equivalent to MODE S @. 

You may want to disable scaling when defining window 
limits, or when performing other actions that need absolute 


coordinate references. See the example below, concerning the 
possible conflicts between WINDOW and SCALE. 
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Window and Scale 
A potential problem arises when using both the WINDOW 


and SCALE commands. The results depend on which command is 
used first. 


Example: 

WINDOW 9,0, 511,383, 

SCALE -10060,1900, 1900,-1900, 
The window limits have been set to the upper left quarter of 
the screen. Then, the coordinate space of the window has 
been defined to be from -1800 to +1000 in both X and Y 
directions. The window limits are still confined to the 
upper left quadrant of the screen, however. You can see this 
by the command sequence 

SHIFT SET BLUE (Set background color to Blue) 

ERASE PAGE (Clear the window to background color) 


If we do the same steps in a different order, we get an 
entirely different result. 


Example: 
SHIFT SCALE (Turn off scaling) 
SHIFT WINDOW (Set window size to full screen to 


undo the above example) 
SCALE -18900,1900, 1999,-108090, 
WINDOW 9,0, 511,383, 


First, the SCALE command causes the screen corners to assume 
coordinates of -19090, 19090, and 1009, -190@. Then the WINDOW 
command, acting within these new coordinates, defines the 
window limits to be @, @ (the center of the screen) to 5l1l, 
383 (a point not far from the center). Now try the same 
sequence: | 


SHIFT SET BLUE 

ERASE PAGE 
The window limits of 9, ® to 511, 383 are now acting within 
a coordinate space of plus and minus 19090. Instead of 


covering the upper left quarter of the screen, the blue 
background now covers only a small area near the center. 
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Defining a window, and then scaling it, can be very 


useful. A window can be defined and then scaled to the full 
screen coordinates. 


Example: 


WINDOW @,@, 511,511, 
SCALE 9,9, 1623,19823, 


<full-scale drawing> 


SHIFT SCALE 
WINDOW 512,9,10923,511, 
SCALE 9,0, 1923,1923, 


<another full-scale drawing> 


This iS an easy way to put two (normally) full-sized 
drawings on the screen at once. Up to four drawings can be 


drawn at this size; scaling smaller windows will allow more 
Simultaneous displays. 


NOTE: 


The easiest way to set both window size and scale 


factors to default is to enter SHIFT SCALE and 
SHIFT WINDOW (in that order). 
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Hardcopy 

The CGC 7998 can interface to several hardcopy devices, 
including the ACTI printer and the Versatec V-8@ 
printer/plotter. 

Software for these drivers are shipped either on DOS 
disks or in PROM. Depending on the driver, the Bitmap (or 
the visible image) can be copied to the device by pressing: 

SHIFT COPY 
-~ OR - 
USER h 


Complete instructions are shipped with the interface. 
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Chapter 4 -- Terminal Emulator (TERMEM) 


The Terminal Emulator (TERMEM) is a program which executes 
automatically when the 7988 is booted. It configures the system 
to act like a communications terminal. The primary function of 
the Terminal Emulator is to read characters from input devices 
and transmit these characters to output devices. 


The default input devices are the keyboard (device K), and 
RS232 serial port (device L). The default output devices are 
Window A (device A), and the RS232 serial port (device L). As is 
the case with most of the 7900's defaults, these assignments may 
easily be changed. 


TERMEM may run in local, half duplex or full duplex modes, 
with a wide variety of baud rates to Suit many peripheral or host 
devices. This section describes each configuration, and options 
available in TERMEM, 


NOTE : 


Local, half duplex, and full duplex modes have _ no 
meaning except within a program such as the Terminal 
Emulator. Other programs may also communicate with 
external devices, but they do so through the logical 
device assignment system. See "Assigning Physical 
Devices" in this chapter. 


If another program is running, the Terminal Emulator may be 
re-entered by pressing the key marked TERMINAL. (This key is 
disabled while running Idris.) | 


The code sequence structure of the CGC 7999 is affected by 
the configuration (half duplex, full duplex or local) of TERMEM, 
Escape and User code sequences are processed on the input stream, 
so typing an Escape or User code sequence will always result in 
immediate processing, regardless of the system configuration. 


On the other hand, Mode and Plot codes are not processed 
until they reach an output device which recognizes them (the 
windows). If the 7990 is operating as a full duplex terminal, 
the host system must echo Mode and Plot codes or they will not be 
executed by the 7969. 


If it is necessary to transmit an Escape or User code to the 
host system, and NOT have this code trapped by the 79898 code 
processor, you must hit Escape or User twice in a row: 


ESC ESC transmit ONE Esc to the host 
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Restricted Terminal Emulator 


A restricted version of TERMEM is available by typing 
the command: 


USER * 


The restricted Terminal Emulator is Similar to the normal 
TERMEM, except that control codes from a host system are 
trapped. This prevents the host from putting the system in 
an unknown state. 


The following control codes are accepted by the 
restricted TERMEM: 


@ Return @e Backspace 
e Linefeed @ Tab 
e Bell e Erase Page 


Other control codes sent from the host are displayed as 
visible control-characters for diagnosis. 


All Escape and User sequences will be executed normally 
from the 7998 keyboard. Mode and Plot codes will execute 
from the 7999 keyboard normally ONLY if the system is not in 
Full Duplex mode. (In full duplex, Mode and Plot codes are 
not executed until they are echoed from the host, and the 
restricted TERMEM traps them). 
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Local Mode 
Local operation is one of the three communications 


arrangements which are provided. 
(normally the 
(normally a window). 
This is the default arrangement, and must 


Input Device @ 
Logical Output Device @ 
device is ignored. 


be used whenever a host 
connected. 
Format: 

USER L (Local operation) 


Hold down the SHIFT modifier 
press the L key. 


aaRnIEE 
LogInDev QO | 
~ 


{ 
| 
: (Keyboard) 


+ 

., ieee bnbey: 3 | 

; (Serial Port) | 

es bee ere 
(The device assignments 
assignments. 
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In Local operation, Logical 
keyboard) is connected to 
The external 


Or peripheral device is not 
and press the USER key. Then 
a: 
| logOutvdev 1 | 
paveenay Porn oD. 
=~ 
\ a 
SY LogQutDev 0 | 
| (Window) : 
Pees aac 
in parentheses are default 


These may be altered with the ASSIGN key.) 
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Half Duplex Mode 


In half duplex mode, Logical Input Device 8 is connected 
to Logical Output Devices @ and 1. This is the only case 
where one Logical Input Device is connected to more than one 
Logical Output Device (see "Assigning Physical Devices"). 
Also, in half duplex, Logical Input Device 1 is connected to 
Logical Output Device @. 


Formats: 
USER H (Half duplex operation) 


The following figure illustrates the connections defined in 
Half duplex. 


-—— 
| Logindey: 0 ae 
| (Keyboard) | 

eee ee ree 


LogOutDev 1 | 
(Serial Port) | 
Bi a ae oh AC pare ee 


at ERLE So 


Pincha a aaa 
| LogInDev 1 - LogOQutDev Q | 


arta Port) | —_ (Window) | 


(The device assignments in parentheses are default 
assignments. These may be altered with the ASSIGN key.) 
Half duplex is used when it is necessary to transmit 


keyboard data to an external device and simultaneously 
display it on the screen. 
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Full Duplex Mode 


If the external device is a host computer, or other 
intelligent interface, full duplex mode may be required. 
Full duplex is similar to half duplex, in that it defines a 
path to an external device. However, in full duplex mode, 
the external device is required to echo back the characters 
it receives. Thus, anything typed on the keyboard will be 
received back from the external device as an echo, and the 
double assignment shown above is not required. 


All data received from the host will be displayed, 
whether it originated as data from the 799@ or was originated 
by the host. 

Format: 
USER F (Full duplex operation) 


The following figure illustrates the connections defined in 
full duplex. 


PT a 
LogInDev OQ Lawbusties 
(Keyboard) § | (Serial ay 
‘ eli aieeend 


ete, | ee eee 
| LogInDev _\ LogOutDev O | 
CWindow) | 


| (Serial Pont) | ; 
eee eet eee ee ee Ser ts 


ee cae ccetenatce 


(The device assignments ain parentheses are default 
assignments. These may be altered using the ASSIGN key.) 
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Keyboard Sync 


The keyboard sync command forces the lighted keys on the 
keyboard to accurately reflect the status of the current 
window (the window receiving the Keyboard Sync command). 


Format: 
MODE ? 


Remember that most Mode code sequences alter only the state 
of the window which receives them, and consider the following 
set of events: 


1) The system is addressing window A oe default 
window), and the user presses one of the lighted keys. 


2) The key lights up to indicate the window has changed 
States. For example, assume the user has turned on 
the "Blink" attribute, and the BLINK key is now lit. 
(Appendix A tells us that the "Blink" command is a 
Mode code sequence, and will only affect the window 
which receives it.) 


Now, suppose the user assigns the output to window B (using 
the “Assign" command above). Window B has not received a 
"Blink On" command, so it does not have its "Blink" attribute 
turned on. But the keyboard lights still reflect the status 
of window A! This can result in considerable confusion. To 
avoid these problems, always perform two steps whenever 
assigning output to a window: | 


1) Remember to assign the keyboard lights (device KX) 
whenever asSigning output to a new window. 


2) Immediately after assigning output to a new window, 
perform a Keyboard Syne (MODE ?) command. 
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Serial Communications 


The 79980 is equipped with two serial ports, for 
communication to a host computer or other device. One of 
these ports is RS-232, the other is RS-449. (RS-232 has been 
the “industry standard" interface for data communications for 
many years, and RS-449 is a new standard now coming into 
use.) A Case Table provides translation of characters to and 
from the host system. 


Fach port uses an interrupt-driven input and output 
buffer. The default size of each buffer is 2048 bytes. Each 
port defaults to 7 bits, even parity, one stop bit, 9699 
baud. All of these defaults may be altered using the "Thaw" 
command. 


Often, it will not be possible to transmit data 
continuously into or out of the 7909, due to delays in 
processing data. The interrupt-driven buffers allow the 
system to handle a certain amount of delay, but if the 
buffers become full, some form of handshaking is required so 
that the receiving system may tell the transmitting system to 
pause. The 7999 recognizes two types of handshake: software 
handshake (also known as X-On / X-Off protocol), and hardware 
handshake. 


When connecting the serial ports for software handshake 
(or if no handshake will be required), the ports should be 
connected according to the diagram on the following page. 
Since many systems use non-standard wiring on serial ports, 
you should study this diagram carefully and connect ONLY 
those pins required for your application. RS-23 2 
communication generally requires only 3 wires. 


If hardware handshake is required, you must connect 
other signals: 


DTR Data Terminal Ready, and the equivalent 
RS-449 signal, indicates that the port is able 
to receive data. 


DSR Data Set Ready, and the equivalent RS-449 


Signal, determines whether the host is 
prepared to accept data. 
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Use these two signals only if hardware handshaking is 
Specified. For software handshaking, the 7988 asserts DTR 
always true, and ignores DSR. Note that RS-449 has two 
Signals which correspond to Data Set Ready; these are DM 
(Data Mode) and TM (Test Mode). If either of these signals 
are true, they indicate a "ready" condition. 


The diagrams also show how an RS-449 port may be used to 
communicate with an RS-232 device. This arrangement will 
often work, but success will be determined by the exact 
nature of the equipment at each end. It is important to 
realize that an RS-449 receiver will withstand signals up to 
plus or minus 15 volts, but some RS-232 drivers will produce 
up to 25 volts and could danage the RS-449 receiver. (There 
is no danger if you are interfacing between Chromatics CG 
Series and/or 7960 Series computers, since the maximum 
voltage used in these systems is 12 volts.) 


RS-232 communications cables, or cables between RS-232 
and RS-449 ports, should be kept under 5@ feet in length. A 
cable between RS-449 devices may be up to 2900 feet in 
length. 


The 7968 asserts RTS (Request To Send) always TRUE. 


Page 4-8 Version 1.4 


Chapter 4 © 79060 Operator's Manual Serial Ports 


Table 4-1. Serial Port Pinouts 


RS-232 (25-pin connector) 


Pin # Signal Description 


2 TxD Transmitted Data (output) 

3 RxD Received Data (input ) 

4 RTS Request To Send (output) 

5 CTS Clear To Send (input) 

6 DSR Data Set Ready (input) 

7 Gnd Signal Ground 

20 DTR Data Terminal Ready (output) 


Other pins are not connected in the 7909. 


RS-449 (37-pin connector ) 


Pin # Signal Description 


4 SD-A Send Data (out put : equiv. to TxD) 

22 SD-B 

6 RD-A Receive Data (input: equiv. to RxD) 

24 RD-B 

7 RS-A Request to Send (output: equiv. to RTS) 
25 RS-B 

9 CS-A Clear to Send (input: equiv. to CTS) 
27 CS-B | 
11 DM-A Data Mode (input: equiv. to DSR) 

29 DM-B 
13 RR-A Receiver Ready (output: equiv. to DTR) 
31 RR-B 
18 TM Test Mode (input: equiv. to DSR) 

20 RC Receiver Common (used for TM only) 
19 Gnd Signal Ground | 


Other pins are not connected in the 7960. 


~ 
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Serial Port Connectors 


The two serial port connectors are located on the rear 
edge of the CPU card, on the right side of the chassis (see 
the figure below). After connecting your cables, the rear 
door of the 7999 should be closed to maintain proper 
ventilation. Sufficient clearance exists under the door to 
allow a serial port cable to exit. 


Recommended Serial Port Wiring 


The connections below are recommended for applications 
where software handshaking (X-On / X-Off) will be used. If a 
modem is used (instead of a terminal), the definitions of 
"transmit" and "receive" must be reversed at the modem 
connector. 


Table 4-2. Serial Port Connections (for software handshake) 


RS-232 Terminal RS-232 Terminal 
TxD 2 were rrr 3 RxD 
RXD 3 terror 2 TxD 
Gnd 7 ------------ 7 Gnd 

RS-232 Terminal RS-449 Terminal 
TxD 2 s33e<+------- 24 RD-B 
Gnd. ). RSseSssSsS== 6 RD-A 
RxD: .3. SS SSSeee Sa e= 22 SD-B 

RS-449 Terminal RS-449 Terminal 
SD-A 4 ------------ 6 RD-A 
SD-B 22 ------------ 24 RD-B 
RD-A 6 ------------ 4  SD-A 
RD-B 24 ~----------- 22 SD-B 
Ghd. Lo s=s=-==-s<=+< 19 Gnd (see text) 
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If hardware handshaking is required, the following wires 
will also need to be connected (in addition to the wires 
listed above): 


Table 4-3. Serial Port Connections (for hardware handshake) 


RS-232 Terminal RS-232 Terminal 
DTR 29 ------------ 6 DSR 
DSR 6 -2---------- 20 DTR 

RS-232 Terminal RS-449 Terminal 
DTR 29 ------------ 29 DM-B 
Gnd 7 ------------ 11 DM-A 
DSR 6 ------------ 31 RR-B 

RS-449 Terminal RS-449 Terminal 
RR-A 13 ------------ 1l DM-A 
RR-B 3] ------------ 29 DM-B 
DM-A 1] ------------ 13. RR-A 
DM-B 29 ------------ 31 RR-B 
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Set Serial Baud Rate 
Format: 
USER S <port #>, <baud rate>, 
Where: 


<port #> is the identifying 
serial port 


Chapter 4 


of the 


<baud rate> is the baud rate to which the port 


will be set 


Two serial ports are installed in the 
system. They are identified by number as follows: 


RS-232 serial port: @ 
RS-449 serial port: 1 
Sixteen standard baud rates are provided: 


58 
75 
119 
134.5 
150 
380 
609 
1209 
1800 
2000 
2409 
3690 
4809 
7200 
9600 
19280 
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NOTE: 


To set the baud rate to 134.5. you must enter the 
number 134 as <baud rate>. Decimal fractions are 
not accepted. 


If an unrecognized baud rate is entered, no action will be 
taken. 


Examples: 
USER S @,300, (set RS-232 port to 380 baud) 
USER § 1,1200, (set RS-449 port to 12098 baud) 


The system defaults to 96998 baud for both serial ports. This 
may be changed using the "Thaw" command. 
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Set Serial Parity, Word Length, Stop Bits 
Format: 
USER s <port #>, <bits> <parity> <stop> 
Where: 
<port #> is the identifying number of the serial port 


<bits> specifies the number of bits per character 
(5, 6, 7, or 8) 


<parity> specifies EVEN, ODD, or NO parity (E, O, or N) 


<stop> specifies the number oof stop bits ‘per 
character (see below) 


NOTE: 


Each of the three parameters <bits>, <parity>, and 
<stop> is entered as a Single character. No commas 
are used to separate them. | 


Two serial ports are installed in the standard CGC 798@ 
system. They are identified by number as follows: 


RS-232 serial port: @Q 
RS-449 serial port: 1 


<bits> is a single character. It may be either the character 
5, 6, 7, or 8. <bits> determines the number of data bits 
transmitted for each character sent out the serial port 
(excluding parity bits). 


<parity> is the single character E, O or N. It determines 
even or odd parity, or no parity. 


<stop> is the single character l, 2 or 3. If <stop> = 1, one 
stop bit is transmitted after each character. If <stop> = 2, 
two stop bits are transmitted. <stop> = 3 is a special case 
and produces 1.5 stop bits per character. 
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Examples: 


USER s 9, 7N1 7 bits, no parity. one stop bit. 
USER s l, 5E2 5 bits, even parity, two stop bits. 


Both serial ports default to 7 bits, even parity, one stop 
bit. This corresponds to standard ASCII transmission. (This 


can be changed using the "Thaw" command.) 


The three parameters may be entered in any order; thus, 


7E1L is the same as 175 or El7. 


NOTE: 


Entering an invalid sequence of characters for 
<bits>, <parity>, or <stop> may hang the serial 


port. 
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Reconfigure SPC Ports : 


.The Chromatics Serial Port Controller (SPC) is an 
optional plug-in board. It adds four RS-232 serial ports to 
the 7990. The ports are numbered S, T, U and V (see Table 
3-1). All SPC ports have the same pinouts as shown in 

_ previous diagrams. 


All four ports default to software handshaking 
(X-ON/X-OFF), 7 bits, even parity and one stop bit. The 
default baud rates are 9699 baud for devices S and T (ports @ 
and 1), 1200 for device U (port 2) and 308 for device V (port 
Bs 


A "reconfigure" command allows you to alter these 
default settings. 


Formats: 


USER r <p>,<h>,<b>, <bits><parity><stop>; 


Where: 
<p> is the port number on the SPC board (9 to 3) 
<h> is the handshaking code for the port (8 to 3) 
<b> is the baud rate. The available baud rates are 
the same as those for the CPU RS-232 port. 
<bits> is the number of bits per character (5 to 8) 


<parity> is the parity type (E, O or N) 


<stop> is the number of stop bits (l1 to 3 -- 3 
produces 1.5 stop bits per character) 


Handshaking codes are as follws: 
@ No handshaking 
1 Software handshake (X-ON/X-OFF) 
2 Hardware handshake (using DTR and DSR) 
3 Both software and hardware handshaking) 
Example: 
USER r @,2,48690,8N2; 
This example would set device S (port 9) to hardware 


handshake, 4899 baud, 8 bits per character, no parity and 2 
stop bits. | 
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Set Host EOL Sequence 
The Set Host EOL (End-Of-Line) Sequence command is used 
in conjunction with other commands, to allow a host system to 
read data from the 7908 system. The commands which transmit 


the values of Window Variables also transmit the EOL 
sequence. 


Format: 
USER z <n>,<n>,<n>,<n>,<n>,<n>,<n>,<n>, 
Where: 


<n> is the decimal equivalent of an ASCII character. 


NOTE: 


This command requires entering a lower case 
character, 2Z. If the ALPHA LOCK key is in its 
normal (up) position, press the SHIFT key with the 
"Z" key to produce a lower case Z. 


The Host EOL Sequence may contain up to eight characters. 
Fach character is entered as a decimal number. Refer to 
Appendix F for the decimal equivalents of ASCII characters. 
If your required EOL Sequence includes less than eight 
characters, zeros must be entered to bring the total number 
of characters to eight. | 


Examples: 
USER z 4,9,0,0,9,0,0,0, 


The Host EOL Sequence is now a Control-D, required by some 
systems as an End-Of-Text marker. 


USER z 13,19,0,9,9,0,0,0, 


This sets the Host EOL Sequence to a Carriage Return/Line 
Feed. This is the default condition. 
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DMA Access 
This command requires the PIO/DMA card, an optional 
plug-in card available from Chromatics. The PIO/DMA card 
must have its base address set to SFF8400.. 
Formats: 
USER D <addr>, <words>, <@ or 1> 
Where: 
addr is the hexadecimal base address of memory 
to be affected. This value MUST be even. 
words is the number of words to be transferred. 


@ or 1 determines the direction of transfer: 


9: DMA from host to 7969 
l: DMA from 790@ to host 


Examples: 
USER D AQOO0G. 32768, 1 


Send 32768 words starting at address AQ9900 (hex) to the 
host from the 7900. 


USER D 19000, 4760, @ 


Send 47@@ words from the host to address 19000 (hex) in the 
7900. 
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Case Table 


The 79098 is a highly flexible terminal for any host 
computer system, in addition to its stand-alone computing 
ability. Since several characters (Mode, Plot, Escape and 
User) are reserved by the 7908 software for control 
sequences, these characters would not normally be available 
for use by a host system. If the host system asSSigns a 
Special meaning to one of these characters, a conflict could 
occur. The Case Table translates claracters transmitted or 
received through a serial port into whatever characters the 
host system requires. 


The Case Table is a list of 256 eight-bit values. 
Whenever a character iS transmitted or received through 
EITHER of the serial ports on the CPU, it is first translated 
through the Case Table. A separate Case Table is not 
provided for each port. | 


The Case Table is loaded with the values @ through 255, 
so that no translation occurs. For example, an ASCII 'A' 
indexes into location 65 in the table and finds the value 65. 
The value from the Case Table would be transmitted, which 
causes the Case Table to appear transparent. 


NOTE: 


DEL (rubout) is not filtered by the Case Table by 
the Terminal Emulator in versions 1.2 and later. 
This was changed to allow easier use of Binary Mode 
in coordinate data (Binary Mode uses DEL 
characters). The default Case Table is now 
transparent to all characters. 


To return to the arrangement provided in TERMEM 1.1. use the 
following commands: 
USER v 127,90, (translate DEL to null) 


USER v 255,90, (86-bit DEL likewise) 


Version 1.4 | Page 4-19 


Case Table 79998 Operator's Manual Chapter 4 


Swap Case Table Entry 


The following command allows swapping any two characters 
in the Case Table: 


USER w <N1>, <N2>, 


Where <N1l> and <N2> are decimal numbers between @ and 255, 
and are the decimal equivalents of ASCII characters to be 
translated. 


NOTE: 


This command requires entering a lower’ case 
letter, w. If the ALPHA LOCK key is in its normal 
(up) position, press the SHIFT key with the "W" key 
to produce a lower case w. 


This command provides a way to resolve the “host conflict" 
problem described above. For example, if the host system 
used Control-A (the 7908 Mode character) as ae system 
interrupt code, it would not be possible to use this 
character in programs. The command 


USER wl, 5, 
would interchange CTRL A with CTRL E every time either of 
these characters went through the 79998 serial ports. (We are 
assuming here that CTRL E would be an unused character in the 
vocabulary of the host system.) This translation would allow 


the host system to use CTRL E as a Mode character in 
transmission to the 7999. 


Set Case Table Entry 


This routine sets a Single entry in the Case Table 
instead of swapping two entries. 


Format: 
USER v <entry>,<value>, 


Where <entry> is the number of the entry in the Case Table 
and <value> is the value to be placed in that entry. 


Example: 
USER v 13,19. 


will change the Carriage Return. character to a lLinefeed 
(NewLine). 
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Chapter 5 -- The Create Buffer 


The Create Buffer is an area of system memory used to store 
commands and characters. When the Create Buffer iS active, any 
characters or commands typed will be executed normally. They 
will also be stored in the Create Buffer. After a set of 
instructions has been stored in the Create Buffer, it may be 
repeated using the REDRAW key. Commands also allow editing the 
contents of the Create Buffer. 


If the Create Buffer fills up, characters are no longer 
stored in the Create Buffer. The system says "Bong," and the 
light in the CREATE key goes out. (In practice, the Create 
Buffer seldom fills up. The Create Buffer is normally allocated 
a larger portion of system memory than any other buffer in the 
79608.) 


Create Buffer processing occurs at the same point as Escape 
and User code processing. All input from Logical Input Device 9 
is trapped for the Create Buffer, and if the system is in Half or 
Full duplex, all input from Logical Input Device 1 is also 
trapped. This results in all characters typed on the keyboard or 
received through the serial port being inserted into the Create 
Buffer when it is active. 
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Create Buffer ON 
Format: 
CREATE 


Pressing the CREATE key causes that key to light up, 
indicating that the Create Buffer is ON. This action 
initializes the buffer, so if there was any information in it 
previously, it is now gone. All characters or commands typed 
at this point will enter the Create Buffer. 


Create Buffer OFF 
Format: 
SHIFT CREATE 


Holding down the SHIFT modifier and pressing CREATE will 
turn off the Create Buffer. Anything typed after this 
command will not be stored in the Create Buffer. The lamp in 
the CREATE key will go out. This command is also used to 
terminate the Append and Insert functions described on the 
following pages. 


If Create is on, Simply pressing CREATE will also turn 
off the Create Buffer. 
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Append to Create Buffer 
Format: 


USER A 


The Create Buffer is turned back on, but is not initialized. 
Anything typed will be appended to the end of the Create 


Buffer. The previous contents of the Create Buffer are still 
intact. 


NOTE: 


This command should NOT be used if there is 
nothing in the Create Buffer (as would be the case 
after power-up). Append will not work properly if 


the Create Buffer has not been initialized using 
Create On. 


The Append function is terminated using SHIFT CREATE. 
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Redraw the Create Buffer 
Format: 
REDRAW 
The contents of the Create Buffer are transmitted to Logical 
Output Device 9. Under default conditions, this will cause 
the Create Buffer contents to be transmitted to the screen. 


Only RESET can interrupt a REDRAW. If the Create Buffer is 
not already off when REDRAW is executed, REDRAW turns it off. 


Transmit the Create Buffer 
Format: 
XMIT 
The contents of the Create Buffer are transmitted to Logical 


Output Device l. Under default conditions, this is the 
RS-232 serial port. 
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Define a Sub-Buffer 


In many cases, you will want to set up a very complex 
sequence of commands in the Create Buffer. It is useful to 
be able to define Sub-Buffers, which can be manipulated 
individually. A Sub-Buffer is established by inserting a 
CTRL X into the Create Buffer. Up to 32767 sub-buffers may 
exist. 


Format: 

CTRL X 
(Hold down the CTRL modifier and type an X.) Sub-Buffers may 
be accessed individually with the following commands. 
(REDRAW and XMIT will always operate on the entire Create 
Buffer, regardless of any Sub-Buffers which may exist.) 
NOTE: 

CTRL X will be transmitted to a host system like a 


normal ASCII character. Make sure that this will 
not interfere with the host. 


Version 1.4 | Page 5-5 


Sub-Buffers 7998 Operator's Manual Chapter 5 


Insert into Sub-Buffer 
Format: 
USER * <n>, 
Where: 


<n> is a decimal number, telling which sub-buffer to 
insert into. | 


A search is performed for the start of Sub-Buffer <n>. At 
the completion of the search, the Create Buffer is turned on. 
Any characters or commands typed from that point on will be 
Stored, beginning at the front of Sub-Buffer <n. . 


If Sub-Buffer <n> is not found, the insertion takes 
place at the end of the Create Buffer. This is the same as 
the "Append to Sub-Buffer"™ function. 


Examples: 
USER * @, 


Characters typed in will now be stored at the front of 
Sub-Buffer @, which means they will be at the front of the 
Create Buffer. Even if no Sub-Buffer markers are being used, 
this is a handy way to insert something at the beginning of. 
the Create Buffer. | 


USER *~ 2, 


Characters typed in will now be stored at the front of 
Sub-Buffer 2. When a REDRAW is performed, they will occur 
after the contents of Sub-Buffer 1, but before the present 
contents of Sub-Buffer 2. 


NOTE: 


If you are inserting near the front of the Create 
Buffer, and the Create Buffer contains a large 
amount of data, there may be a noticeable delay 
while the insertion is performed. 


This command should not be used if there is 
nothing in the Create Buffer (as would be the case 
after power-up). See the warning under "Append to 
Create Buffer." The Insert function is terminated 
by SHIFT CREATE. | 7 
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Kill a Sub-Buffer 
Format: 
USER K <n>, 
Where: 


<n> is a decimal number corresponding to the Sub-Buffer 
you wish to eliminate. 


The Sub-Buffer numbered <n>, if it exists, will be 
eliminated. All Sub-Buffers with numbers greater than <n> 
will move down one number. All Sub-Buffers with numbers less 
than <n> will be untouched. 


Examples: 
USER K @, 


Sub-Buffer 9 (the first one) will be killed. Sub-Buffer l 
will become Sub-Buffer @, 2 becomes 1, and so on. If no 
Sub-Buffer markers exist, the entire Create Buffer is killed. 
(This can also be accomplished by typing CREATE, followed by 
SHIFT CREATE.) 


USER K 4, 


Sub-Buffer 4 will be killed, if it exists. (If fewer than 
four Sub-Buffers exist, no action is taken.) Sub-Buffers 9 
through 3 are unchanged. Sub-Buffer 5 will become 4, 6 will 
be 5, and so on. 
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View a Sub-Buffer 
Format: 
VIEW <n>, 


Where: 


<n> is a decimal number, corresponding to the 
Sub-Buffer you wish to view. 


Sub-Buffers are numbered consecutively, beginning with the 
number @. To view any Sub-Buffer, hold down the SHIFT 
modifier and press the key marked REDRAW and VIEW. Then 
enter the number of the Sub-Buffer you want to see. The 
contents of that Sub-Buffer will be redrawn to Logical Output 
Device 9 (normally the screen). 


Examples: 
VIEW 9, 


The first Sub-Buffer will be redrawn. If no Sub-Buffer 
markers exist, this will perform the same function as REDRAW. 


VIEW 3, 
The fourth Sub-Buffer will be redrawn. If the system cannot 


find three Sub-Buffer markers, it will assume a fourth 
Sub-Buffer does not exist, and no action will occur. 
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Literal Create 
Format: 


USER | 


Literal Create is used to allow inserting 


Literal Create 


Escape code 


sequences into the Create Buffer. Escape code sequences are 


normally not allowed in the Create Buffer, 


Since they can 


cause undesired changes in the system configuration. If you 
wish to insert Escape codes into the Create Buffer, you 


should go through the following steps: 


1) Turn on Create with one of "Create On," 
"Append to Create Buffer" or "Insert Into 


Sub-Buffer" 


2) Turn on Literal Create with USER [ 


Now, any Escape code sequences entered will be executed AND 
stored in the Create Buffer for future redrawing. 


Literal Create remains in effect until the Create Off 
command is given. Normal codes will still go into the Create 


Buffer while Literal Create is turned on. 


NOTE: 


Many of the keys on the upper half of the keyboard 
' produce Escape code sequences. It is not always 


obvious which ones will, or will not, 


be put into 


the Create Buffer. If Literal Create is NOT on, 
commands such as Zoom and Pan, or Change Color 
Lookup Table Entry, will be executed but will NOT 
be stored in the Create Buffer. Consult Appendix A 
to see which keys produce Escape code sequences. 


Under no circumstances are User code 


allowed in the Create Buffer. 
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Thaw Parameters 


The THAW command allows you to configure various aspects 
of the 79690 system, such as buffer sizes and default baud 
rates. The information supplied to Thaw is _ stored in 
optional CMOS RAM (with battery backup while power is down), 
Or in static RAM memory. If CMOS is installed, parameters 
set up by Thaw are remembered during power outages, and used 
the next time the system is powered up. If the CMOS option 
is not installed, information given to Thaw is_- only 
remembered until the system is shut off. 


Format: 
THAW 


Thaw also displays some important system variables, which 
are not stored in CMOS, but may be of interest to the systems 
programmer. It is possible (but not recommended) to alter 
these variables as well; however, the values of items not in 
CMOS will not be remembered when the system is turned off or 
Booted. 


Using Thaw, it is possible to allocate system RAM so 
that it serves your purposes efficiently. It is also 
possible to allocate more RAM than your system contains. In 
this case, the system will attempt to recover by reverting to 
PROM default values. 


NOTE: 


To erase CMOS completely, and return to the 
defaults your system was shipped with, press Ml M2 
CTRL SHIFT RESET. Release RESET before releasing 
the other keys. 


Thaw takes you through a list of system parameters. For 
each parameter, it displays a brief description, followed by 
the currently assigned value for that parameter. It then 
displays a colon (:) to ask whether you want to change that 
parameter. You may hit RETURN to leave the value unchanged, 
Or enter a new value, followed by RETURN. You MUST hit 
RETURN after entering a value, or the value you enter will 
not be accepted. If you press DELETE (instead of RETURN), 
the system will ignore your input even if you did enter a 
value. 3 
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All numerical values supplied to Thaw are in 
hexadecimal. DO NOT enter the dollar sign to indicate a hex 
number. Thaw displays an 8-bit, 16-bit, or 32-bit number, 
depending on the legal range of values for the entry. 


After stepping through all entries. Thaw begins again 
from the start. Once you have changed all the entries you 
need to change, press RESET. (RESET is the ONLY way to exit 
from Thaw. After pressing RESET. you will note the green 
light on the keyboard turns on, then goes off.) If you had 
changed any of the “buffer size" parameters, you should also 
press BOOT. This will re-configure the system according to 
the new defaults you have entered. 


CAUTION: 


If you alter any of the "buffer size" parameters 
uSing Thaw, and then exit Thaw WITHOUT executing 
Boot, the system may become confused and fail! 
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DOSTranZ 
DOSBuf fz 
#Windows 
KeyBuffzZ 
Fnk Nest 
232 InzZ 
232 OutZ 
449 Inz 
449 OutzZ 
Esc ArgZ 
StackZ 
Upper RAM 
FnkStart 
FnkEnd 
CaseTble 
DefltPrg 
RAM MDLE 
232 Mode 
449 Mode 
232HandS 
449HandsS 
232 Baud 
449 Baud 
Planes 


WinTable 
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abbreviations are 


Size of DOS transient program area 
DOS buffer size 

Number of windows 

Keyboard buffer size 

Function key stack size (for nesting) 
RS-232 Input buffer size 
RS-232 Output buffer size 
RS-449 Input buffer size 
RS-449 Output buffer size 
Escape code argument stack size 
System stack size 
System upper memory limit 

Starting address of function key buffer 
Ending address of function key buffer 
Case table address 

Default program to execute at Reset 
Address of RAM modules to be linked 
RS-232 USART mode command 
RS-449 USART mode command 


RS-232 Handshake flags 


RS-449 Handshake flags 


RS-232 Baud rate flag 


RS-449 Baud rate flag 
Image planes in system 


Base address of Window Tables 


used by Thaw: 


Thaw Parameters 
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StackTop Top of system stack 

StackBtm Bottom of system stack 

CreaStrt Starting address of Create Buffer 
CreatEnd Ending address of Create Buffer 
Boot$ String to execute at Boot time 
Reset$ String to execute at Reset time 


IDnbufs Number of block buffers used by Idris to cache 
disk I/O 


IDclists Number of lists used by Idris to buffer 
character I/O 


IDchar Controls disk I/O indicator (at top right 
corner for Idris) 


IDheap Stack+heap size used by Idris 

IDbase Base address for Idris execution 
IDrswap Space used by Idris swap cache 

IDtop Top of Idris user memory 

IDroodev Idris root device flags 

IDpipdev Idris pipe device flags 

IDswpdev Idris swap device flags 

IDswapa Beginning block of Idris swapping area 
IDnswap Size (in blocks) of Idris Swapping area 
IDcsw Idris "console switch register" 


These parameters are discussed on the following pages. 
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DOSTranZ: default $4990 bytes (16K bytes) 
DOSBuffZ: default S$1AG@@ bytes 


Range: @ to S7FFE bytes (even numbers only) 


The DOS transient area and buffer are allocated 
consecutively in memory. Generally, programs run in the 
transient area, and use the buffer area for any large 
data storage needs. These two areas may be combined and 
used as a single DOS area in some applications. 


The size of the DOS buffer determines how much 
memory is available for disk operations such as COPY or 
COMPRESS. The larger this area is, the faster such 
operations will run. Making this area very small will 
result in excessive wear to the disk media during these 
operations. 


#Windows: default 3 
Range: 9 to 7 


The system may have from one to eight windows 
active. The "“#Windows" paramete@ contains a number ONE 
LESS than the number of active windows. 


KeyBuffZ: default $48 bytes (64 bytes) 


Range: @ to S7FFE bytes (even numbers only) 

This buffer provides "type-ahead" capability. 
Characters typed on the keyboard are stored here until 
read by a program. 

Fnk Nest: default $88 bytes (128 bytes) 
Range: $18 to S7FFE bytes (even numbers only) 

This area is a stack, used to provide "nesting" when 
One Function Key is used to execute another Function Key. 


Fach level of nesting requires 8 bytes. A minimum of $19 
bytes (16 bytes) is recommended. 
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232 InZ: default $898 bytes (2K bytes) 
232 OutZ: default $8090 bytes (2K bytes) 
449 InZ: default $8860 bytes (2K bytes) 
449 OutZ: default $898 bytes (2K bytes) 


Range: $10 to S7FFE bytes (even numbers only) 


Each buffer is used by the serial port routines to 
handle incoming and outgoing characters. Do not set 
buffer sizes below $18 bytes (16 bytes). | 


Esc ArgZ: default $499 bytes (1K bytes) 
Range: $1@ to S7FFE bytes (even numbers only) 


Escape and User codes accept arguments, and these 
arguments are stored temporarily in this area. Do not 
set the buffer size below $19 bytes (16 bytes). 


StackZ: default $808 bytes (2K bytes) 
Range: $80@ to S7FFE bytes (even numbers only) 


The system stack is used for subroutine calls and 
for temporary storage in many system programs. It is 
used especially during the Complex Fill routines to store 
screen coordinate data. The system stack size should not 
be reduced below $8@@ bytes (2K DY ESE) | 


UpperRAM: default SI1F99@ 
Range: depends on system hardware 


The system allocates RAM among all of the buffers 
listed in this section. Whatever RAM is left over, up to 
the limit set by UpperRAM, is allocated to the Create 
Buffer. In a standard 79990 system, only one Buffer 
Memory card is installed, and the physical end of Buffer 
Memory is at address SI1FFFF. If you have purchased 
additional Buffer Memory cards, you may wish to move 
UpperRAM to a higher address so that the Create Buffer 
can use more memory. 


The system defaults to SI1F98@ for UpperRAM so that 
the area between SI1F990 and SIFFFF may be used for small 
user programs. UpperRAM may be moved down to provide 
more room for user programs. 


See also RAM MDLE on page 6-8. 
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FnkStart: default SE49990@ 
FnkEnd: default SE4Q@BFF 


Range: may be moved to Buffer Memory (See below) 


Function Key definitions, including Bezel Key 
definitions, are normally stored in CMOS memory between 
addresses SE498980 and SE4@BFF. This provides 768 bytes 
of storage. If your application requires more room for 
Function Key definitions, you may choose to move these 
addresses into Buffer Memory. For example, you could set 
FnkStart to S1F99@, and FnkEnd to SIFFFF, to provide 4K 
of storage for Function Keys. Note that this removes 
Function Keys from CMOS, so their definitions would be 
lost when the system is turned off. 


Memory addresses SE49C®® to SE4@CFF are reserved for 
the Inline Editor (used in Thaw, DOS, and the Monitor). 
The Function Key buffer may not be expanded into this 
area. 


CaseTble: default SE46809 
Range: may be moved to Buffer Memory (See below) 


This is the address of the Case Table (see "Serial 
Ports.") It may be moved to Buffer Memory if desired. 
However, the information contained in the Case Table 
would then be lost when system power is turned off. The 
Case Table is 256 bytes long. 


DefltPrg: default $802008 

Range: may be any address in PROM or RAM 

DefltPrg contains the address to which the system 
will jump after Reset or Boot. The default address is 
that of the Terminal Emulator program. Other useful 
addresses are: 

Monitor: S88A098 

DOS: S88COH8 

Idris: $80 EG G8 
NOTE: 

These addresses are valid for TERMEM 1.4, but 


may change in future firmware releases. 


If this location is set to an address where a valid 
program does not exist, the system will crash. 
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MDLE: default S1F00@ 


Range: may be any RAM address 


232 
449 


When the 7999 Boots, it "links" all system routines 
together and enters them into "dispatch tables" for 
procesSing via code sequences. User routines may be 
linked as well, if they conform to the requirements of 
the 7998. User routines to be linked must be loaded at 
address RAM MDLE. See Appendix E for details on adding 
commancs to the 796@. 


Mode: default S7A 
Mode: default S7A 


Range: any value from the table below 
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The RS-232 ports and RS-449 ports are initialized 
with a "Mode Select" byte, which determines the number of 
bits per word, number of stop bits, and parity. The Mode 
Select byte is fed to the 8251 USART on the CPU card. 
You can determine the proper Mode Select for your 
application from the following table: 


Upper 4 Bits Lower 4 Bits 
1 stop bit, no parity: 4 5 bits: 2 
1 stop bit, odd parity: 5 6 bits: 6 
l stop bit, even parity: 7 7 bits: A 

8 bits: E& 

1.5 stop bits, no parity: 8 
1.5 stop bits, odd parity: 9 
1.5 stop bits, even parity: B 
2 stop bits, no parity: C 
2 stop bits, odd parity: D 
2 stop bits, even parity: F 


For example, the default Mode Select is S$7A. This 
corresponds to 1 stop bit and even parity (7), and 7 bits 
(A). 


Further details are available in Intel literature 
cescribing the 8251 USART. 
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232HandS: default $01 
449HandS: default $861 


Range: $@8 to $@3 


These flags set the handshaking characteristics of 
the serial ports, according to the following table: 


998: No handshaking 
®1: Software handshaking (X-on, X-off) 
@2: Hardware handshaking (DTR and DSR signals) 
93: Both software and hardware handshaking 
232 Baud: default SE 
449 Baud: default S@GE 
Range: $@0 to S@F 


These values set the default baud rates of the 
serial ports, according to the following table: 


GZ: 5@ baud G8: 18090 
91: 75 G9: 2000 
92: 110 GA: 2400 
93: 134.5 | OB: 3600 
G4: 158 GC: 4800 
G5: 30@ QD: 72090 
G6: 660 GE: 9600 
G7: 1200 OF: 192900 


Planes: default $9091, S8087 or SOOFF (typical systems) 
NOT CMOS! 


The number of Image Memory planes installed in your 
79900 determines the value of this entry. This is a 
16-bit number, and each bit which is SET corresponds to 
an existing plane. Bits which are ZERO correspond to 
planes which are not installed. A four-plane system, 
containing planes numbered 9, 1, 2 and 7, would display 
the value $@@87 for Planes. 


This item is displayed for information only. It 
Should not be altered with Thaw. The value of Planes is 
determined by testing each Image Memory plane when the 
system is booted. | 
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WinTable: default $763C 
NOT CMOS! 


WinTable is the base address of the Window Tables, 
the system memory areas used to define the attributes of 
each window. 


This item is displayed for information only. It 
should not be altered using Thaw. WinTable will vary 
depending on buffer allocations. , 


StackTop: default SAAFC 
StackBtm: default SA2FC 


NOT CMOS! 


The top and bottom of the area reserved for the 
system stack are displayed here. The system loads the 
Stack Pointer (SP) with StackTop at boot time. 


These items are displayed for information only. They 
Should not be altered using Thaw. StackTop and StackBtm 
will vary depending on buffer allocations. 


CreaStrt: default SAAFC 
CreatEnd: default SlEFF8 


NOT CMOS! 


The starting and ending addresses of the Create 
Buffer are displayed here. The Create Buffer is 
allocated most of the system's memory. after all other 
buffers have been allocated. The Create Buffer ends 
Slightly below UpperRAM (a few bytes of margin for EOF 
are provided). 


These items are displayed for information only. 


CreaStrt and CreatEnd will vary depending on other system 
parameters. 
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Boot $: default USER I 1L USEROI1L2Z2Z4zZ 
Range: any 75 characters 


The "Boot String" is executed at power-up and when 
Boot is executed. It acts just as if you had typed in 
these characters from the keyboard. The Boot String and 
Reset String’ (described below) provide a very flexible 
way to establish system defaults. Virtually any system 
function may be executed by default, simply by including 
it in the Boot String or Reset String. 


The Boot String is stored in CMOS. The default Boot 
String, listed above, assigns Logical Input Device 1 to 
the serial port, and assigns Logical Output Device 1 to 
the Serial Port and three dummy devices. 


User and Escape code sequences may be entered into. 
the Boot String. The "User" character is abbreviated 
with a "UR," and the "Escape" character is abbreviated 
with an "EC." 


It is not useful to enter alphabetic characters, or 
Mode and Plot codes, into the Boot String. This is 
because the window for Logical Output Device 9 has not 
yet been assigned: this occurs during execution of the 
Reset String (see below). The Boot String is primarily 


useful for executing commands such as "Clock On," "Half 
Duplex," or setting Logical Device Assignments as shown 
above. 


All of the character-oriented text editing features 
labelled on the cursor keypad may be used to edit the 
Boot String. This includes Insert/Delete Character, 
Clear EOL, and the arrow keys. See Appendix C for a 
complete discussion of the Inline Editor. 
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Reset $: default USER I @ K USER O @ AK ZZMODE J 1 
Range: any 75 characters 


The "Reset String" is executed after a Reset, and 
also after a Boot. (At Boot or power-up time, the Boot 
String executes first, followed by the Reset String). 
The Reset String is stored in CMOS. 


The default Reset String, listed above, assigns the 
keyboard and window A as the default Logical Devices. It 
also turns on the cursor with a Mode code sequence. Mode 
and Plot characters may be included in this string, and 
they will be displayed in abbreviated form. 


See the discussion of Boot String above for more 
details. 
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Thaw Parameters for Idris 


IDnbufs 


IDclists 


IDchar 


IDheap 


IDbase 


IDrswap 


Version 1.4 


This is the number of 5l2-byte block buffers used 
by Idris to cache disk I/O. Idris will run, albeit 
Slowly, with only 2 buffers. An incredibly huge 
number will also slow Idris down due to the search 
overhead. By the mean value theorem, therefore, 
there must be happy medium. For normal 
applications, the default value of 15 (Oxf), 
consuming 8.5K, works well. 


Clists are data structures used by Idris to buffer 
tty-type character I/O. Each clist can hold 12 
Characters, and the clists are shared among all 
tty-type devices. Fully burdened, a tty-type 
Character device can consume up to 512 characters 
worth of clists. A safe position would be to 
provide 512 bytes worth of clists for each actively 
used tty-type device. AS it turns out, the default 
value of 55 provides only 669 bytes worth of 
clists. This is adequate for one tty, but not so 
good for more than one. A better default might be 
512*2/12 = 85 to support two fully loaded ttys. 


This parameter controls the funny little character 
that winks on and off during disk I/O. You can 
completely eliminate it by setting IDchar to zero. 
The upper byte sets the foreground and background 
transparency attributes, while the lower byte is 
the actual ASCII character. 


This is the stackt+theap size used by Idris. The 
default is 58009 bytes which is a good guess. 


This is the address to which the boot’ prom 
relocates Idris for execution. The default is 
9x20000, which is the second 128K bank of memory. 
At the expense of the create buffer, you can move 
Idris downward and recover at least 64K of often 
unused memory. To do this, first set UpperRAM to 
O@xFOOO, then set IDbase to O@xlVO@ad. 


This 1s the amount of space allocated to the Idris 
Swap cache. The swap cache is another one of those 
avoid-going-to-disk techniques which is extremely 
effective. A value of 64K is usually sufficient. 
If IDrswap 1s zero, Idris goes looking for a bank 
of memory following the first 128K gap. This 
implies changing around the address select switches 
on the memory boards in order to make them 
non-contiguous. We recommend using IDrswap 
instead. 
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IDtop 


IDroodev 
IDpipdev 
IDswpdev 


IDswapa 
IDnswap 


IDcSw 
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If non-zero, IDtop places a maximum memory 
restriction upon Idris. This can be used if a 
section of upper RAM is to be devoted to some other 
purpose. 


These parameters alter Idris's idea of the device 
containing the root file system, the device on 
which to perform piping, and the device on which to 


perform swapping. They only become valid, however, 


if the @x1@000 bit is set in IDcsw (below). 
Otherwise, the compile-time values within Idris are 
used. The default Thaw values are coincidentally 
the same as the compiled-in values. The defaults 
are @x@4@2 (major device 4, minor device 2, alias 
/dev/hard@®@) for the root device and the piping 
device, and Ox Z4G6 (alias /dev/hard@l1) for 
Swapping. 


These two values instruct Idris as to the starting 
block address and size (in blocks) of the swapping 
area on the swap device. IDswapa must not be zero, 
due to the swap space allocation scheme. As with 
the device parameters above, these parameters are 
not effective unless the @x1@00@ bit is set in 
IDcsw. | 


This is the console switch register (what ever 
happened to the good ole days of switches and 
lights?). Programs can read its value uSing the 
getcsw function, which is erroneously documented as 
csw in the Idris Programmers Manual. The upper 16 
bits are reserved for Chromatics use, while the 
lower 16 are all yours. The only bit currently 
dedicated is the 9x19900 bit as described above. 
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Default RAM Allocation 


The following chart describes default RAM allocation in 
version 1.4 of 79800 system software. The sizes of buffers 
marked with asterisks (*) may be altered with Thaw, which may 
alter the starting addresses of other buffers. 


To the right of the table are the addresses of pointers. 
These pointers contain long-word addresses which will always 
indicate where buffers start, regardless of Thaw. FOr 
example, $C28 always holds the address of the RS-232 Input 
Buffer. : 


All addresses between S@ and S1C3C are fixed in this 
version of firmware, and cannot be changed with Thaw. 
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Default Contents Pointer Location 
Interrupt 
Vectors 


Scratch Pad RAM 
Used by Monitor 


TERMEM Pointers 


$1489 
Rubber Band CLU 
Save Area 
$1688 <—. ($CBB) 
TERMEM 
$1c3c <— (5054) 
DOS Transient 
Program Area 
($4869 bytes*) 
$5C3C <— (SCC) 
DOS Buffer 
($1A96 bytes*) 
$763C <— (SCAB) 
Window Table @ 
Window Table 1 Each Window Table takes 512 bytes. 
Window Table 2 


They are allocated consecutively. 


STE3C <— ($CH4) 
Keyboard Buffer 
($48 bytes*) 
S7ETC <— (SCIC) 
Function Key 
Stack 
($88 bytes*) 
S7EFC <—— ($C28) 
($880 bytes*) 
S86FC <— (S$C2C) 
RS=232 Output 
Buffer 
($888 bytes*) 
S8 EFC <=— ($C30) 
RS-449 Input 
Buffer 
($808 bytes*) 
$96FC <— ($C34) 
RS~449 Output 
Buffer 
($880 bytes*) 
S9EFC <— ($C38) 
Esc Processor 
Argument Buffer — 
($498 bytes*) 
SA2FC <— (SCAB) 
System Stack 
($868 bytes*) 
ee aoe 
SAAFC <— (SCAC) 
Create Buffer 
(gets the rest 
of memory) 
Se ae 
$1F080 <— (SE4912A) 


Unused RAM 


Additional Buffer Memory 
may be installed above SI1FFFF. 
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Chapter 7 -- Numerical Data and Window Variables 


Numerical Data 


In an earlier chapter, we mentioned briefly that the 7969 
expects decimal numbers to be delimited by a comma or 
semicolon. This chapter discusses the various forms in which 
numerical data may be accepted by the 79090. Some advanced 
features of the 7998 are mentioned in this chapter, but are 
not described in detail until later chapters. 


Numerical data is used to enter coordinates’ for 
plotting, for window limit definition, for color numbers, and 
to set up many other system features. The numerical data 
will usually have a value between -32768 and +32767, or 
between @ and +65535. Numerical data may be accepted in one 
of several forms, depending on the current state of the 
system: 


1) A decimal number. Decimal numbers are entered as you 
would normally type a number on the keyboard. A decimal 
number ALWAYS ends with a comma or semicolon. Failure to 
provide the comma or semicolon will usually cause the 
system to continue accepting characters until a comma or 
a semicolon IS found. This will almost certainly enter 
erroneous data into the system. 


A decimal number may have a leading + or - Sign. If, 
while entering a decimal number, you discover that you 
have entered a wrong digit (BEFORE striking the 


terminating comma), you may press the + or - key to 
cancel that entry and then re-enter the correct data. 
Pressing the + or - key resets the “argument collector" 


so that it begins parsing that entry again. 


Examples of decimal numbers: 


l7, (Each of these numbers 
+17, evaluates to seventeen.) 
13+17, 


2) If Binary mode is on, each number must be entered in a 
Special binary form. Binary mode is discussed later in 
this chapter. 


3) If Binary mode is NOT active, the system will accept a 


Window Variable anywhere a decimal number is allowed. 
Window Variables are discussed next. 
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Window Variables 


Each window has a number of variables which may be used 
to store temporary data. These variables are referenced by 
alphabetic names, A through z, and the names of variables may 
be used anywhere a decimal number may be used in any system 
command. Each variable is allocated 16 bits (1 word) of 
storage, sO a variable can store numbers from -32768 to 
32767. 

The Window Variables named A through W, and [, \, ], “*- 
_, -» are completely available for the user. Variables X, Y 
and Z are also available if the optional Digitizer Pad is not 
being used. Variables named a through z provide access to 
certain items in the "window table" (the set of data defining 
the current status of the window). These variables should be 
modified with caution. 


The values of most Window Variables are lost when the 
"Soft Boot" command is executed. Only the current cursor 
positions are preserved. | 


Since the names of Window Variables are alphabetic 
characters, and entering a Window Variable name is equivalent 
to entering a decimal number, you are cautioned against 
entering text while the system is in Plot mode. The text 
would be interpreted as Window Variable names, causing 
unpredictable numbers to be plotted. 
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Window Variable Assignments 
Usage 
User-defined 

? 


e 
" 


Used by optional Digitizer Pad 
Used by optional Digitizer Pad 
Used by optional Digitizer Pad 


User-defined 
"w 


Overlay cursor X position 
Overlay cursor Y position 
Bitmap cursor X position 
Bitmap cursor Y position 


Overlay window Xl position 
Overlay window Yl position 
Overlay window X2 position 
Overlay window Y2 position 
Bitmap window Xl position 
Bitmap window Yl position 
Bitmap window X2 position 
Bitmap window Y2 position 


Bitmap character raster size (X) 
Bitmap character raster size (Y) 


Bitmap 
Bitmap 
Bitmap 
Bitmap 


intercharacter spacing (X) 
intercharacter spacing (Y) 
character X multiplier 
character Y multiplier 


Virtual coord X minimum 
Virtual coord Y minimum 


Tab stop spacing 


Vector 


width 


Background color 
Foreground color 


Plane select value 


(Not used, reserved) 


Window Variables 
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Operate on Window Variable 
Format: 
MODE ] <var> <op> <N> 
Where: 
<var> is one of the window variables, A through z 


<op> is an arithmetic, logical, or assignment operator 
in the set =+- */&! 


<N> is a decimal number followed by a comma, or 
another Window Variable | 


This command assigns a value to a Window Variable, or 
modifies it in some way. 


The = operator assigns the value <N> to the variable 
<var>. The arithmetic operators +, -, * and / perform 
addition, subtraction, multiplication and division. The 
logical operators & and ! perform a 16-bit logical AND and 
OR, respectively. 

Examples: 

MODE ] A= 1, set variable A equal to l 

MODE ] A+ 1, increment the variable A 

MODE ] A + B let A=A+t+B 


A AND 7 


MODE ] A & 7, let A 
NOTE: 
Do NOT put spaces in any of these command 


sequences. Spaces are shown here for readability 
ONLY. 
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Display and Transmit Window Variables 


Commands are provided to display the value of a Window 
Variable or transmit this value to a host system. They 
Operate identically except that the Display command sends the 
value to Logical Output Device 9 (normally a window), and the 
Transmit command sends the value to Logical Output Device 1 
(normally the RS-232 serial port). 


Each command also sends the "Host EOL sequence" after 
sending the variable value. The default EOL sequence is a 
Carriage return and line feed. 


These commands always send values as decimal, -32768 to 
+32767. 


Format: 
USER x <win> <var> (Transmit variable) 
USER y <win> <var> (Display variable) 
Where: 
<win> is the desired window, A through H 


<var> is the name of a Window Variable, A through z 


NOTE: 


Each of these commands requires entering a lower 
case character. x or y. If the ALPHA LOCK key is 
in its normal (up) position, hold down the SHIFT 
key and press the "X" or "Y¥" key to produce a lower 
case xX Or y. 


These commands point out that the value of a Window 
Variable is specific to a window. You must specify which 
window you are interested in, when requesting the value of a 
Window Variable. Windows are named A through H. Often 
window A (the "Master Window") is the only window in use; 
however, its name must still be specified. 


Example: 


USER y Av display the currently specified vector width 
for window A. 
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Example of variable operations and display: 


DEFINE Fl Define Function Key Fl to be: 
USER yA A display variable A (window A), 
MODE ] A+ 1, and increment gariewe A./ 

Fl End of Fl definition. 


Now, pressing Fl repeatedly displays the integers, 1. 2. 3, 
and so on. : 
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Window Variable Uses 

Window Variables give the user direct access to many of 
the attributes which define a window. They are especially 
useful to alter some window attributes which are not otherwise 
accessible. 
Example: 

MODE ] u = 8, 
This example sets the tab stops in a window to 8, producing a 
stop every eight columns. There is no Mode code sequence 
assigned to perform this function, so the Window Variable 
operator is the only means available for setting tab stops. 
Example: 

SHIFT OVERLAY 

RECT 

ijkl 
The four Window Variables i, je k and 1 define the 
coordinates of a-.-window in the Bitmap. This example draws a 


rectangle with those coordinates, producing a rectangle 
Surrounding the current window. 
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Binary Mode 


Binary mode is provided so that a host system, or user 
program, can transmit coordinate data more efficiently. When 
Binary mode is on, all numbers which are normally entered in 
decimal must be entered in a special binary fashion. This 
includes all arguments to MODE and PLOT codes, except for 
flags (<@ or 1> type arguments). 


Formats: 
MODE B <@ or 1> 
Using the character 9 will turn off Binary mode (the default 
state), the character 1 will turn it on. 
NOTE: 
Binary mode is NOT recommended for use from the 
keyboard! In Binary mode, color keys and many 


other keys on the upper half of the keyboard will 
not operate normally. 


In Binary mode, each number entering the system must be 
encoded into two 8-bit bytes. The bitS are arranged as 
follows: 


First Byte: 


. SSesteetans Seas tentente Sheena shentetententestatenentententententenentenentententen + 
| Xx | 1 | S |...ehigh 5 618.4421 
S sieetntents Shestesteste Samtentants sretententestestentetentestentantententententestetentan + 
T 
Sign bit 
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In each byte. bit 7 is ignored and bit 6 must be al. 
This insures that only printing ASCII characters will be 
used. Bits 5 through 9 of the first byte make up the 
low-order 6 bits of the resulting value, and bits 5 through 9g 
of the second byte make up the high 6 bits. Binary mode thus 
limits arguments to being signed ll-bit numbers. 


If bit 5 of the second byte is a 1, the number will be 


negative. 
Example: 
MODE B l (Turn on Binary mode) 
MOVE X-Y PC PC (Move cursor to location 200.299 -- 


Binary mode value “PC") 


Binary Mode (Escape Code Processor) 


Binary Mode can be confusing since it can be ON or OFF 
for each window. The Escape Code Processor can also work in 
Binary Mode; it operates on all ESC and USER codes without 
regard to windows. 

Formats: | 
ESC B <@ or I> 


Usually. you will want to set Binary Mode for the Escape 
Code Processor AND the windows you will work in. 
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Chapter 8 -- The Bitmap 


The 7998 Bitmap screen is designed for the creation of very 
high resolution images. It is arranged as a square set of square 
pixels, 1924 horizontally by 1924 vertically. Because of the 
dimensions of the display CRT. an area of 18024 horizontally by 
768 vertically is the maximum viewable at any time (see Figure 
8-1 on the next page). The remaining pixels are normally held 
offscreen below the viewable CRT area. 


The Bitmap can display images in up to 256 colors, depending 
on the hardware installed in your unit. The basic model 7969 
contains enough Bitmap memory to allow Simultaneous display of 16 
colors. As each additional Bitmap memory plane is added, the 
number of displayable colors doubles. 


Regardless of the number of Bitmap memory planes in your 
system, the 7990 always has a "palette" of 16 million colors 
(actually 16,777.216). Your selection of colors may always be 
chosen from the full palette. 


A second set of Bitmap planes can be added to the 7900. This 
second set does not increase the number of available colors, but 
instead allows you to create two independent images. This second 
image memory must contain the same number of Bitmap planes as the 
first image, allowing the two separate images to each display the 
Same colors. A maximum of sixteen Bitmap memory planes (eight in 
each of two image memories) may be installed. 


The term "Bitmap" refers to the way in which pixels are 
addressed in the 7909 hardware memory circuits. In a 
conventional memory arrangement, the units or "“bits" of memory 
are not individually addressable. It is not possible to alter a 
Single bit of memory without reading a group, or "word," of such 
bits, altering one of them, and writing the entire word back into 
memory. Since each bit of memory is associated with a Single 
pixel, it is much faster to write to a single pixel without 
disturbing its neighbors. 


The 79990 does just that. The Bitmap hardware and software 
Can write or read the value of any individual pixel on the Bitmap 
screen. If only one Bitmap memory plane was installed, it would 
be .necessary to read only a Single bit for each pixel. If 
several planes are installed, the Bitmap operates on one bit OF 
EACH PLANE every time a pixel is altered. 


If your system contains four Bitmap memory planes, four bits 
are responsible for the color of each pixel. These four bits are 
added in a binary fashion to produce a number. The number refers 
to an entry in the Color Lookup Table, and this entry determines 
the color of that pixel. (The Color Lookup Table is explained 
later in this section.) 
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Bitmap Defaults 


“When the 79899 is powered up, or booted with the BOOT key, 
the Bitmap is initialized as follows: 


@e Alpha (not Plot) 
® Page (not Roll) 
@ Cursor at upper left corner of screen (8,90) 


@e Color Lookup Table loaded with default values (see 
page 8-15) 


@® Bitmap image is NOT erased (except at power-up) 
“Remember that when the system is booted, the Overlay is 
not transparent. You cannot see the Bitmap image after a 
Boot until you press SHIFT OVERLAY (see "Bitmap Operations") 
Or until you make the Overlay transparent (see "Modify 
Overlay Visible Attributes"). 


The Bitmap image is not erased when the system is 
booted. If an error occurs while you are creating an image 
on the Bitmap screen, in most cases you will be able to 
recover without losing the image. (The Color Lookup Table 
may have to be reloaded if you have altered it.) 


After a Boot, a new cursor is installed at the "home" 
location of the screen. If a cursor had been on the screen 


when Boot was executed, the old cursor will still be at its 
Old location after the Boot and you will have to remove it. 


F x 10293, 787 
Thie area te 
vevally data —— Z LL ly a 
unieee panned LA FAH, 
or zoomed. !1923,1029 


— 8-1. Screen Layout (Bitmap) 
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Bitmap Operations 


This section discusses the types of commands accepted by 
the Bitmap. Before you can talk to the Bitmap, you have to 
get its attention. This is accomplished by the important 
command: 


SHIFT OVERLAY 


Hold the SHIFT key and press the lighted key marked OVERLAY. 
The light will go out. The Overlay window will become 
immediately transparent. foreground and background, to allow 
you to see the Bitmap. Any commands or characters entered 
will now be processed (or, if illegal, ignored) by the 
Bitmap. 


When you want to talk to the Overlay again, press 
OVERLAY 


The light in the key will light up, and you are again 
addressing the Overlay. This action causes the Overlay 
window to become non-transparent, so that any messages in the 
Overlay will now be visible. 


NOTE: 


When switching back and forth between Overlay and 
Bitmap, be aware of the light in the PLOT key. If 
you are plotting in the Bitmap and then return to 
the Overlay to enter text, you will still be in 
Plot (as indicated by the lighted PLOT key). To 
return to Alpha for entering text, press SHIFT 
PLOT. See "Exiting Plot Submodes" on page 9- 28 for 
details. 


If you want to address the Overlay or the Bitmap, 
without disturbing the Overlay transparency attributes, use 
the, following commands: 

MODE O @ (Overlay "off" - addresses Bitmap) 

MODE O 1 (Overlay "on" - addresses Overlay) 

These commands will not affect the present attributes of the 


Overlay, but they will determine whether the Overlay or the 
Bitmap will process future commands. | 
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As an illustration, remember that the 7998 uses 
"windows" as its primary output devices. A window can 
display characters, perform graphics functions, and handle 
other actions. Each window is allowed to perform functions 
in the Overlay and in the Bitmap. For example, when a window 
receives a character, it may place this character into an 
Overlay character cell, or it may generate a series of Bitmap 
pixels to form the character. 


The command MODE O <@ or 1> determines which part of the 
window software will handle an incoming character, and 
whether the resulting display will occur in the Overlay or 
the Bitmap. Then, the Overlay transparency attributes will 
determine whether this character will be visible or not. 


The OVERLAY key produces the following code: 
MODE O 1 
MODE V 3 
SHIFT OVERLAY produces the following code: 
MODE O @ 
MODE V @ 
NOTE: 
Each example in this section is independent. Every 
example assumes that it will not be affected by any 
prior example (unless noted). To insure that each 
example executes independently, it is advisable to 
execute the command sequence: 
RESET BOOT SHIFT OVERLAY 
before beginning each example. In addition, to | 


insure a "clean" screen for each example, you may 
wish to erase the screen. 
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Bitmap Blink 


In the Bitmap, the Blink attribute occupies one Refresh 
Plane of image memory. The highest numbered plane is 
normally used for blink, so the "blink plane" will normally 
be plane 7. (Regardless of how many planes your system has, — 
one of the planes may be configured to be number 7.) If a bit 
is ON in the "blink plane," it means the pixel corresponding 
to that bit will blink. If the bit is OFF, the pixel will 
not blink. 


Refer to the Color Lookup Table (page 8-15). The upper 
half of the Table, beginning at entry number 128, will be 
accessed by a pixel whose seventh bit is ON. If bit 7 is 
OFF, the lower half of the Table is accessed. 


Now, if we allow that seventh bit to blink on and off, 
we are alternating between the upper and lower halves of the 
Color Lookup Table. The Table is default-loaded with full 
intensity color in the first eight entries, and 
half-intensity of the same colors in the first eight entries 
of the upper half. So any pixel which has the blink bit set 
will blink between full- and half-intensity color. (Black is 
the exception: since half-intensity black would be black, 
the Table defaults to grey in its place. White and black 
will both blink to half-intensity white, which is grey.) 


Since blink occupies one Refresh Plane. it cuts the 
number of available colors in half. In a four-plane system, 
you have a choice: 


1) eight colors and blink 
2) sixteen colors without blink 


Actually, you always have 16 colors even with blink: the 
second eight colors are only seen if the color is blinking. 
For example, under default conditions, an object might be 
specified to be “blinking red." It would be blinking between 
full-intensity and half-intensity red, entries 4 and 132 in 
the Color Lookup Table. If we alter entry 132 to be brown, 
then the “blinking red" object will blink between red and 
brown. This technique allows any object on the screen to 
blink between any two colors. 
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Blink ON 
Formats: 
BLINK 


The BLINK key will light up. Future SET commands will 
reference the upper half of the Color Lookup Table, and will 
cause foreground or background color to blink. 


If you want the foreground color of characters or 
figures to blink, turning on the blink attribute is 
sufficient. Any figures drawn while the BLINK key is lit 
will have a blinking foreground. 


If you want the background to blink, the procedure is a 
bit more involved. First, turn on blink. Set the background 
color using SHIFT SET <color>, and turn off blink. The 
background, not the foreground, of a character entered into 
the Bitmap will now blink. (This procedure is only relevant 
to characters, since graphics figures do not use background 
color.) 


NOTE: 


When Blink is ON, the 7th bit of any color number 
entered will be set. Color numbers will not be 
modified when Blink is OFF. 


Blink Off 
Formats: 
SHIFT BLINK 


The BLINK key will go out. Future SET commands will 
reference the lower half of the Color poonue Table, and will 
not cause blink. 


NOTE: 


Use of the BLINK key requires that the default 
blink plane be in effect (plane 7). If the "Select 
Blink Plane" command has been used to alter the 
blink plane number, the BLINK key may not produce 
normal results. 
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Select Blink Plane(s) 
Formats 
ESC b <n>, 


Where <n> is a decimal number, 9 to 255. The plane or planes 
specified by bits in <n> will blink. Other planes will not. 


Blink means to alternate between "data" and "@" for that 
plane's contribution to the CLU indexing. 


NOTE: 


This command requires entry of a lower case 
letter. b. When the ALPHA LOCK key is in its 
normal (up) position, use the SHIFT modifier with 
the "B" key to produce a lower case b. 


Examples: 

ESC b @, 
No bits are set "on" in the number @, so no planes will 
blink. This is necessary for applications requiring ail 
available colors (16 in a 4=-plane system). Blink in the 
Bitmap is now completely inhibited. 

ESC b 128, 
The number 128 is examined as a binary number. Only the 
highest bit (bit 7) is found to be "on," so only plane 7 will 
blink. This is the default condition. 


ESC b 255. 


The number 255 has all eight bits set. All planes will 
blink. This is not a terribly useful condition. 
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Set Bitmap Character Size 
Formats: 
SIZE <X>,<Y>, 
Where: 


<X> is the character multiplication factor in the 
horizontal direction 


<Y> is the vertical factor 

The limit for <X> is 170, and the limit for <Y> is 96. This 
size (1798 by 96) corresponds to a size where one character 

fills the entire Bitmap screen. 
Example: 

SIZE 1,1, 
This sets the smallest available character size on the 7980. 
You can now fit 17@ characters on a line, and 96 lines on the 
CRT. With this character size you have the ability to put 
16320 characters on the Bitmap screen. 

SIZE 2,2, 


The Bitmap character size is now exactly equal to the size 
of Overlay characters. This is the default condition. 


SIZE 19.39. 


Note that the <X> and <Y> factors need not be equal. 
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Set Bitmap Intercharacter Spacing 


Format: 
MODE I <X>, <Y>, 
Where: 
<X> is the pixel spacing in the horizontal direction, 
<Y> is the vertical spacing. 
Each time a character is entered into the Bitmap, the cursor 
1s automatically updated to prepare for a new character. 


When a line is complete, or when the LINE FEED key is 


pressed, the cursor is moved down to prepare for the next 
line. 


The spacing between characters on a line, and between 
lines, is set by this command. The default values are 6 for 
<X>, and 8 for <Y>, since the standard character font is 6 by 
8 pixels. 


The spacings entered for <X> and <Y> are always 
multiplied by the current character size before use. This 
allows proper spacing regardless of the current Bitmap 
character size. 

Examples: 
MODE I 6, 8, This is default spacing. 
For bold characters, use the following command: 
MODE I 8, 12. 
NOTE: 
This command only affects the cursor movement and 


has no bearing on the size of the background field 
of a character cell. 
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Load User-defined Character Set 
Format: | 
MODE i <x>, <y>, <addr>, 
Where: 
<x> is the horizontal character raster size 
<y> is the vertical character raster size 
<addr> is the memory address of the character set 


<x> and <y> are decimal numbers. <x> is a positive integer 
from 1 to 16, and <y> ranges from 1 to 256. 


<addr> is a hexadecimal number. It must be a legal 
memory address, or the system will Trap. <addr> must also be 
an even number. If <addr> is zero, the normal character set 
is loaded. 


Example: 

MODE i 8, 10, 19000, 
This command would install a user-defined character set (8 
by 180 pixel font) which has been loaded into RAM at address 
19000 (hex). 


To return to the normal character set, use SOFT BOOT or 
enter the command: 


MODE i 6, 8, @, 


This loads the normal character set and sets the raster 
Sizes to normal (6 by 8). 


There should be <y> words of memory for each of 128 


character definitions. Characters should be in ASCII,format. 
See Appendix E for an example of the character set format. 
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Overstrike 
Formats: 
MODE \ <@ or I1> 


Using the character 1 will turn Overstrike on, and @ will 
turn it off. 


NOTE: 


This command requires entering a backwards slash, 
the character \. The backslash is located in the 
upper right corner of the typewriter area of the 
keyboard, near the RETURN key. It should not be 
confused with the standard slash, /, which is 
located on the question-mark key. 


With Overstrike off (the default condition), writing a 
character to the Bitmap causes a rectangular block of pixels 
to be written. Some of these pixels will form the character, 
and will be written in the current foreground color. The 
other pixels in the rectangular block are written in the 
current background color. 


When Overstrike is on, only the pixels which form the 
foreground of the character are written. The background is 
not altered. This allows multiple characters to be written 
to the same screen location without having each character 
obliterate the previous one. Overstrike can be used to 
create custom characters or symbols, or for underlines, 
accent marks, or other punctuation. 


Example: 
MODE \ 1 


RETURN T E S T RETURN _§ _ __ 
Press the RETURN key to move the cursor to the left edge of 
the window, if it is not already there. Then type the word 
"TEST." Press RETURN again, and while holding the SHIFT key 
down, press the underline key four times. (The underline key 
is on the right side of the typewriter area of the keyboard, 
and is marked with a horizontal line and the name "DEL.") In 
this example, the word "TEST" was underlined without 
disturbing the characters in the word. Now type the sequence 
MODE \ @ (Overstrike off) and try the same example again. 
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Bitmap Color 


In the Bitmap, pressing a color key generates a number. 
This number is a reference to a value in the Color Lookup 
Table. The BLACK key, for example, generates the number @, 
which refers to entry @ in the Lookup Table. Normally, entry 
9 is loaded with components of zero red, zero green, and zero 
blue, which gives black. 


Set Foreground Color 
Formats: 
SET <color> 
Where: 


<color> may be one of the eight color keys, or a 
number, @ to 255. 


The current foreground color will be set to the specified 
color number in the Color Lookup Table. Any figures or text 
which are entered into the Bitmap will have this foreground 
color. 


If a color key is used, and the BLINK attribute is off, 
then the number generated by the color key will be in the 
range @ - 7. BLACK generates 9, BLUE generates 1, and so on. 
If the BLINK attribute is currently on, then the color 
numbers generated will be in the upper half of the Lookup 
Table, and will be in the range 128 to 135. This arrangement 
assumes that plane 7 is the Blink Plane, and allows you to 
specify blinking colors without concern for plane numbers. 


Example: 

SET RED 
The foreground color has been set to red, which is color 
number 4 in the Lookup Table. If BLINK is turned on, the 
foreground color would be set to blinking red, which is color 
number 132. 
Example: 

SET 4, 
The foreground color has been set to color number 4 in the 
Lookup Table. This approach bypasses the question of whether 


blink is on or off. This format would most often be used 
from a host computer. 
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Set Background Color 

Format: 

SHIFT SET <color> 
Where: 

<color> is a color key, or a number between @ and 255. 
All of the comments concerning foreground color apply to 
background color as well. The background color will be set 
to the specified number in the Color Lookup Table. If BLINK 


is on, the upper half of the Table will be referenced by the 
color keys. 
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Color Lookup Table 


The 7988 Bitmap has a color palette of 16,777,216 
colors. At any time, a subset of these colors is available. 
The number of available colors is determined by the number of 
Refresh Planes (Bitmap memory boards) installed in your 
system. 


In the standard system, with four Refresh Planes, 
Sixteen colors are available at any time. Each additional 
board doubles the number of available colors. In a fully 
expanded system with eight Refresh Planes, 256 colors are 
available at any time. 


With sixteen million colors to choose from, which ones 
do you use? 


Color selection in Bitmap memory is performed through an 
indirect technique called the Color Lookup Table. Each pixel 
on the Bitmap screen is associated with a bit in each plane 
of Bitmap memory. The sum of these bits is a number, from 9 
to 255, which references a particular entry in the Color 
Lookup Table. Thus, each pixel "points to" some entry in the 
Color Lookup Table, and the information in that entry will 
determine the color of that pixel. The Color Lookup Table 
has 256 entries, enough to accommodate a configuration having 
eight planes (per image memory). The colors are numbered 
from 9 to 255. | 


Each entry in the Color Lookup table contains three 
86-bit numbers, one for R (the Red component of the color), 
one for G (the Green component), and one for B (the Blue 
component). The intensity of each of these components may be 
altered from 9 (totally off) to 255 (full intensity in the 
color). For example, pure red is 255 R, zero G, and zero B. 
Black is zero, zero, zero. White is 255, 255, 255. Colors 
with less than full saturation (such as greys) will contain 
intermediate numbers between @ and 255. Neutral grey is 128, 
128, 128 (half intensity of each component). 
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The following chart shows default assignments in the Color: 


Lookup Table. 
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The lowest eight entries in the table (@ through 7) 
correspond to the eight color keys on the keyboard: @ is 
Black, 1 is Blue, etc. Halfway up the chart, beginning at 
entry 128, another eight entries are defined to be 
half-intensity of the same eight colors. Only sixteen colors 
are assigned in the default Color Lookup Table because only 
Sixteen colors are available in the basic 7988 system. 


Pixels on the Bitmap screen do not have a color, but 
they have a color value which points to some location in the 
Color Lookup Table. The Color Lookup Table is the mechanism 
by which each pixel is given a color. 
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Modifying the Color Lookup Table 


Change Color Lookup Table Entry (RGB Units) 


CHANGE is the most immediate way to change colors on the 
Bitmap screen. No actual change to the contents of Bitmap 
memory takes place. Each pixel in the Bitmap references some 
entry in the Color Lookup Table, so changing an entry in the 
Table will immediately change the color of each pixel 
referencing that entry. 


Format: 
CHANGE <color>,<R>,<G>,<B>, 
Where: 


<color> is an entry in the Color Lookup Table, @ to 
255. or a color key. (If a color key is 
used, the comma after <color> must not be 
entered.) 


<R>,<G>,<B> are components of Red, Green, and Blue, 
respectively, to be entered into the Color 
Lookup Table. Each must be between @ and 
255. 


The entry in the Color Lookup Table corresponding to 
<color> will be changed to have the components <R>, <G>. and 
<B>. The former components of that entry of the Lookup Table 
are gone. 


Example: 
CHANGE @,255,255.255. 


Color @ (the first entry in the Color Lookup Table) has been 
changed to white. Since the background color defaults to 
color 98, pressing ERASE PAGE will now erase the screen to 
white. (This is not the normal way to change background 
color: see page 8-13.) 


After this change is made, both the BLACK key (which 
normally references color 9) and the WHITE key (which 
normally references color 7) will cause white to be put on 
the screen. This is because our example above has eliminated 
black from the Color Lookup Table. Unless other changes are 
made, there is no entry of the CLU which will produce the 
color black. 
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This points out an important consideration when using 
the Change command: since the Change command alters entries 
in the Color Lookup Table, it is possible to create a 
Situation where the color keys have no meaning. The example 
above will change the BLACK key to mean white. If you change 
entries in the Color Lookup Table, it is your responsibility 
to keep track of those entries and what the color keys now 
mean. 


NOTE: 


The Overlay colors are unaffected by the CLU. 
Thus, the color keys will always have their proper 
meanings in the Overlay. 


The relationship between the color keys and the Color 
Lookup Table is now apparent. In the Bitmap, the color keys 
reference numbers in the Color Lookup Table. Under default 
conditions, these numbers are set up to produce the colors 
designated on the color key. For example, préssing BLUE 
generates the number 1. Entry number 1 in the Color Lookup 
Table is default-loaded with zero red, zero green, and 255 
blue, which produces full intensity blue. If, however, you 
change entry number 1 in the Lookup Table to be some color 
other than blue, the BLUE key will still reference that 
color. Pressing a color key is equivalent to entering a 
number from 9 to 7; the shifted versions produce numbers from 
8 to 15. These numbers are followed by a comma. 


Example: 
CHANGE 9,0,0,9, 


Color number 9 in the Color Lookup Table has been changed to 
black. This is the default condition. 


If you try to change an entry in the Color Lookup Table 


which is not accessible in your system, no visible changes 
will take place on the screen. 
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If you change an entry which is accessible in your 
system, but which is not currently referenced by any pixel on 
the screen, you will not be able to detect a change until you 
use that color again. 


Example: 
SET WHITE (set foreground color to white - color 
SHIFT SET BLACK (set background to black - color @) 
ERASE PAGE (clear the screen to background color) 


CHANGE 7,255,0.0. (change entry 7 - which used 
to be white - to red) 


The screen is still black, since entry 7 is not’ used 
anywhere on the screen at the present time. But anything 
typed will now appear in red, even though the current 
foreground color is number 7, which should be white. 


The primary use for the Change canmand is to produce new 
colors, which are not normally present in the Color Lookup 
Table. In most cases, minor changes in color will be desired 
which will not grossly affect the meaning of the color keys. 
Here are a few possibilities: 


CHANGE BLUE @,149.240. 


The BLUE key now produces a "sky blue" composed of no red, 
149 green, and 249 blue. 


CHANGE YELLOW 255.170.120, 
The YELLOW key now produces a shade of brown. 


As mentioned, when entering a color NUMBER to be changed 
(as in the earlier examples), the number was terminated by a 
comma. When using CHANGE with a color key, no comma is 
entered after the color key. Color keys simply generate the 
digits 9-7 followed by a comma. Shifted color keys generate 
the digits 8-15 followed by a comma. 


In each case, the Color Lookup Table is changed. fThis 
changes the color of every pixel in Bitmap memory which 
references that color. If no images had been drawn in the 
color, no change will be apparent. 
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Change Color Lookup Table Entry (HVS Units) 
Format: 


SHIFT CHANGE <color>, <hue>,<value>,<saturation>, 


Where: 
<color> is an entry in the Color Lookup Table, 9 to 
255, or a color key. (If a color key is 
used, the comma after <color> must not be 
entered.) 
<hue> are the HVS units which describe 
<value> the desired color (see below). 


<saturation> Each must be between @ and 255. 


The entry in the Color Lookup Table corresponding to <color> 
will be changed. The parameters <hue>, <value>, and. 
<saturation> will be converted to RGB units and placed in the 
Color Lookup Table. 


The HVS color model is described in Appendix B. Except 
for the HVS-to-RGB conversion, this command acts exactly like 
the Change command on the previous page. 

Examples: 
SHIFT CHANGE WHITE @,128,9, 


The WHITE key now produces 59% grey (hue is undefined, value 
is 128 or 50%, saturation is zero). 


SHIFT CHANGE BLUE 171,255,128, 
The BLUE key now produces a pastel blue (hue is 171, blue; 


value is 255, full brightness; saturation is 128, or 503%, 
which adds some white to the color). 
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Default Color Lookup Table 
Format: 
ESC 1 <c> 
Where: 
<c> 1S a Single character. 
NOTE: | 


This command requires entering 


Color Lookup Table 


lower case 


letter, 1. If the ALPHA LOCK key is in its normal 
(up) position, hold down the SHIFT key and press 


the "L" key to produce a lower case l. 


This command will load the Color Lookup Table, based on 
a default arrangement of colors. If <c> is the character 
"9," the Color Lookup Table is loaded with the values it had 
when the system was Booted. Pressing the BOOT key also 


reloads the Color Lookup Table. 
Example: 


ESC 1 @ 


Other default arrangements of the Color Lookup Table, for 


imaging and other applications, are 
expansion. 
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Colorswap 


Formats 
COLORSWAP <color 1>, <color 2>, 
Where: 


<color 1> and <color 2> are each a color key or a 
decimal number (terminated by a comma). 


Colorswap exchanges pixel colors in the Bitmap. Any pixels 
which were <color 1> are changed to <color 2>, and any pixels 
which were <color 2> are changed to <color 1>. Other colors 
are not altered. 


Colorswap affects all pixels in the window receiving the 
command. 


Contrast this command with the CHANGE command: CHANGE 
alters data in the Color Lookup Table to produce a color 
change, but does not alter Bitmap pixel data. Colorswap 
alters only pixel data. This takes considerably longer if 
the window is large. 


Colorswap is useful for altering Bitmap data to suit the 
requirements of a hardcopy device, or other peripheral, which 
may require Bitmap data to be configured in a certain way. 
Examples: 

COLORSWAP RED BLACK 


Any pixels which were red are changed to black, and vice 
versa. 


Colorset 


Format: 
SHIFT COLORSWAP <color 11>, <color 2>, 
This command acts exactly like Colorswap, except that pixel 


data is altered from <color 1> to <color 2> only. Pixels 
which are <color 2> are NOT changed to <color 1>. 
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Bitmap Cursor Control 


The Bitmap has two cursors: an overscore/underscore for 
Alphanumeric use (Similar to the Overlay cursor), and a cross 
hair for plotting. Only one of the cursors is present in a 
window at any time. If more than one window is in use, more 
than one cursor may be visible. Unless otherwise noted, the 
following information applies to both Alpha and Plot cursors. 


The cursor control keys: 


RETURN LF HOME 
CTRL HOME ERASE PAGE CLEAR LINE 
RECALL ERASE EOS CLEAR EOL 


the four arrow keys 


have the same meanings they had in the Overlay. Pressing two 
adjacent arrow keys simultaneously will move the cursor 
diagonally. Since the Bitmap allows variable size characters 
(see "Set Bitmap Character Size"), some functions may depend 
on the currently specified character size. For example. the 
right arrow will always move the cursor one character width 
to the right, regardless of how wide the characters are 
currently defined to be. 


WARNING: 


ERASE PAGE will clear out the image in the current 
window in Bitmap. There is NO WAY to recover this 
image unless it can be reconstructed from the 
Create Buffer or some other source. 


The four text editing functions are also available in the 

Bitmap. These functions are Insert Line, Delete Line. Insert 

Character, and Delete Character. They operate in the same 
manner as their counterparts in the Overlay. 


The arrow keys have an additional meaning in the 
Bitmap: using the SHIFT modifier with an arrow key moves the 
Cursor one pixel in the specified direction. Holding down 
SHIFT while pressing two adjacent arrow keys will move the 
cursor diagonally, one pixel at a time. 


SHIFT left-arrow Dot Left 
SHIFT right-arrow Dot Right 
SHIFT up-arrow Dot Up 

SHIFT down-arrow Dot Down 
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The CURSOR ON key works the same way as it did in the 
Overlay: pressing the key alone turns the cursor on, and 
using SHIFT with the key turns the cursor off. 


NOTE: 


If you turn the cursor off while in the Overlay, 
then switch to Bitmap, the cursor is still off. 
Both cursors are handled by the same command. 


When you switch from Overlay to Bitmap, the 
Overlay cursor disappears and the Bitmap cursor 
appears. Only one of the two cursors will ever be 
visible in a window, depending on whether you are 
currently talking to the Overlay or the Bitmap. 


MOVE X-Y positions the cursor absolutely, as it did in the 
Overlay. 


Formats: 
MOVE X-Y <X>,<Y>, 
Where: 


<X> is a decimal number between 9 and 1923, 
<Y> is between 9 and 767. 


This is identical to the form used in the Overlay except 
that the limits for <X> and <Y> are adjusted to the Bitmap. 
The @, @ position is in the upper left corner. xX increases 
From left to right, and Y increases going down. The Relative 
Move command is also present in Bitmap: 


MODE m <dX>, <dY>, 
This command moves the cursor relative to its current 
position, by <dX> pixels horizontally, and <dY> vertically. 
<dX> and <dY> are each decimal numbers terminated by a comma. 

Tab stops are located every four character cells. 
Pressing the CTRL modifier and the character I moves the 
cursor to the next tab stop. 

CTRL I 
NOTE: 


Tab stops can be changed using the Operate on 
Window Variable command, MODE ]. See page 7-7 for 
details. 
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Set 


Cursor Color 
Format: 

MODE Q <color key> 
The Bitmap cursor will assume the color specified by the 
color key. If the Blink attribute is currently on, the 
cursor will blink. 
Alternate format: 

MODE Q <n>, 
Where <n> is the number of an entry in the Color Lookup 
Table, @ through 255. This format would most often be used 


from a host computer. 


The default cursor color is blinking white, which may be 
established by either of the commands 


MODE Q 135, 
MODE Q -l, 
NOTE: 


The bitmap cursor is software generated and is 
subject to being written over and destroyed. 
Internal precautions are taken to avoid this, but 
using multiple windows makes it possible to damage 
the cursor. The MODE Q command can be used to 
repair the cursor if this happens. 
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Fill Mode 


Many of the "primitive" figures supported by the 
plotting software are "fillable," that is, they can be filled 
as they are drawn. The fillable primitives are: arcs, 
circles, rectangles, triangles, incremental X-bar and Y-bar, 
and the optional polygon (tiler) algorithm. 


To specify that the figure is to be filled as it is 
drawn, the "Fill" attribute must be turned on. 


Format: 

FILL 
The light in the FILL key will illuminate, and the "Fill" 
attribute will be turned on. Whenever the "Fill" attribute 
is on (signified by the lighted key), a figure which is 
fillable will be drawn and filled in the currently specified 
foreground color. 

To turn off the "Fill" attribute, use the command: 


SHIFT FILL 
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Complex Fill Algorithms 


The software described in this section is optional, and 
may or may not be installed in your system. 

Complex Fill algorithms are used to fill, or "paint," an 
area with a color. In some cases this area must be enclosed 
by a boundary of pixels, as described below. Complex Fill 
may be used on ANY types of figures, not only the figures 
Supported by the plotting routines. 


There are, however, some limitations: 


e Complex Fill is a routine which demands a great deal 
of resources from the 7999 processor. An area is 
filled by drawing horizontal vectors, and whenever the 
algorithm encounters a "problem" in the area (such as 
a corner), it must remember the location of the 
"problem" and return to that location later to "solve" 
it. Each location that must be remembered requires a 
certain amount of space in the system's memory stack, 
and trying to fill an extremely complex area can 
overflow the available stack space. If this occurs, 
the fill routine will stop. If the fill routine stops 
before completing a fill of a very complex area, an 
overflow has probably occurred. The StackZ parameter 
in Thaw can be enlarged to remedy this problem; see 
page 6-6. 


@e Another point to remember when using Complex Fill is 
this: the area to be filled MUST be bounded. The 
boundary color must be the same as the color being 
used to fill (Edge Fill) or different from the color 
being used to fill (Area Fill). If a proper boundary 
is not present, the fill algorithm may "leak" and the 
color being used to fill may fill the entire screen. 
Or, if no border exists between the filled area and 
the top of the screen, the fill routine may stop 
filling at some apparently random location. 
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Area Fill 
Formats: 
AREA FILL <color> <X>,<Y>, 
Where: 


<color> is one of the eight color keys, or a number 
corresponding to an entry in the Color Lookup 
Table (@ to 255). If a number is used, it must 
be delimited by a comma. 


<X>,<¥>, are the coordinates of a point INSIDE the area 
which is to be filled. 


The area containing the point <X>, <Y> will be filled with 
the color specified. The fill will stop at any edge 
containing a color other than the color specified. 


Example: 

| CIRCLE 511,383,109, (draw a circle) 
AREA FILL RED 511,383, (f£i11 it with red) 
AREA FILL BLUE 511.383, (now fill it with blue) 


In this example, we drew a white circle, and filled it with 
red. Note that the border of the circle is still white. The 
fill routine terminated when it reached the white edge of the 
circle. Note also that we can re-fill the area with another 
color (in this case, blue). : 


Alternate Formats: 
AREA FILL <color> . 


The cursor position may also be used to specify coordinates. 
In this case, the cursor should be moved inside the area to 
be filled, and then the AREA FILL command may be executed 
uSing the cursor position to specify the <X> and <yY> 
coordinates. 7 
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Edge Fill 
Format: 
SHIFT AREA FILL <color> <X>,<Y>, 
Where: 
<color> is one of the eight color keys, or a number 
corresponding to an entry in the Color Lookup 
Table (@ to 255). If a number is used, it must 
be delimited by a comma. 


<X>,<Y>, are the coordinates of a point INSIDE the area 
which is to be filled. | 


Edge Fill is very Similar to Area Fill, except that Edge 
Fill will fill an area until it reaches a boundary of the 
SAME color it is using to fill. Area Fill would stop at any 
dissimilar boundary. 


Example of Area Fill and Edge Fill: 


RECT 0,8, 511,383, (rectangle around 1/4 of screen) 
SET RED | (set foreground color to red) 
FILL (turn on the "fill" attribute) 
CIRCLE 256,192.79 (circle inside the rectangle) 
MOVE X-Y 20.29. (move cursor inside rectangle) 
AREA FILL BLUE . (fill the area with blue) 


At this point (see illustration), the upper left quarter of 
the screen contains a white rectangle, filled with blue, and 
a filled red circle. The Area Fill command did not cover the 
red circle, nor did it cover the rectangle's white border. 


SHIFT AREA FILL WHITE . (edge fill with white) 
This time, the Edge Fill command filled until it reached the 
rectangle's white border. It covered the red circle, Since 


it does not stop at anything except the color it is filling 
with (white). 
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Joystick 


The CGC 7988 joystick (optional) is a three-axis input 
device. It generates an interrupt to the system whenever it 
is moved off its rest position, in any one of the three axes. 


Formats: 
USER \ <@ or 1> 


Use the character @ to disable the joystick, or 1 to enable 
TC, , 


When the joystick is enabled, it controls cursor 
movement and zoom. The cursor may be moved in the X or Y 
direction by moving the joystick in the appropriate 
direction. Holding the SHIFT key while moving the joystick 
will move the cursor one pixel at a time, for exact 
positioning. The Z-axis of the joystick is used to zoom in 
and out: twist the top knob clockwise to zoom _. in, 
counterclockwise to zoom out. 


In addition, the joystick allows selection of color. 
Once the cursor is positioned over an area whose color is to 
be changed, hold down the Ml key and use the joystick to 
modify the color of the area. This “Joy-Color" mode allows 
you to change the red component of a color by moving the 
joystick in the X-direction; Y corresponds to green, and Z 
(twist) corresponds to blue. . Once the color is satisfactory, 
release the joystick and the chosen color will remain. The 
SHIFT key may be used for slow color changes. 


At the moment the joystick is enabled, the system reads 
values from all three axes, to establish the "zero" position. 
It is important that the joystick be at rest when the 
"enable" command is given. | 


NOTE: 


Since the joystick operates at the interrupt 
level, nothing done with the joystick may be stored 
in the Create Buffer. 
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Pan and Zoom 


The CGC 7988 includes hardware facilities to zoom or pan 
a high-resolution image in the Bitmap. These functions do 
not affect the contents of Bitmap memory; they alter the way 
in which the information in the Bitmap is displayed on the 
CRT screen. 


zoom is performed by magnifying each pixel in memory. 
The system will zoom in any integer multiple from 1 to 16 
times. Commands described below allow setting the X and Y 
zoom levels simultaneously, or independent of one another. 


Pan is performed by altering the address of the pixel 
being displayed in the upper left corner or the screen. When 
the zoom level is higher than 1 (default), pan allows viewing 
Gifferent areas of the image at high magnification. Pan is 
also used to allow viewing the bottom 256 lines of Bitmap 
memory, which are normally hidden offscreen below the 
viewable area. 


Note that all pan and zoom functions apply to Bitmap 
memory only. The Overlay cannot be panned or zoomed. This 
allows menus, or other information in the Overlay to remain 
stationary while the Bitmap image may be examined with pan or 
ZOOM. 


Pan and zoom are manipulated using the cursor control 
keys (the four arrows and HOME), and the ERASE PAGE, CLEAR 
LINE, and RECALL keys, all used in conjunction with the M2 
modifier key. 


Pan Left M2 left-arrow 


Pan Right M2 right-arrow 


Pan Up M2 up-arrow 
Pan Down M2 down-arrow 
Reset Pan M2 HOME 


You can use the REPEAT key to speed up any of the panning 
operations. 


The two following commands always zoom towards (or away 
from) the Bitmap cursor in window A (the "Master Window"): 


Zoom Up M2 ERASE PAGE 


Zoom Down M2 RECALL 
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The following command adjusts the Pan registers so that the 
cursor is visible. The cursor is not moved. 


Pan to Cursor Location M2 CLEAR LINE 


See the Joystick description for other ways of controlling 
zoom and pan. 


NOTE: 


Joystick zoom and pan always tries to keep the 
cursor centered on the screen without causing the 
image to wrap. This is an aesthetic judgement and 
can only be overridden by using Absolute Zoom and 
Pan. 
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Absolute Pan 

Formats: 
PAN X-Y <X>,<Y>, 

Where <X>, <Y> are the desired coordinates of the upper left 
corner of the screen. The pan registers will be aligned to 
place the point <X>, <Y> in the upper left corner of the 
viewable screen. (Only absolute coordinates are allowed in 
this command: any scale factors in use will not be 
recognized.) 
NOTE: 


PAN X-Y is a single key. This label is on the 
front of the key marked MOVE X-Y. 
Examples: 
PAN X-Y 511,383, 


The point 5ll. 383, which is normally the center of the 
screen, will be moved to the upper left corner of the screen. 


PAN X-Y 9.9. 


This command will reset pan to its default state, and is 
equivalent to M2 HOME. 
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Absolute Zoom 
Format: 
ESC Z <ZX> <ZY> 


Where <ZX> and <ZY> are each Single characters. Note that no 
commas are used to separate <ZX> and <ZY>. 


The binary composition of the ASCII characters <ZX> and 
<ZY> will set the zoom registers. Since the zoom factor can 
vary from 1 to 16, the contents of the zoom registers may 
also take on 16 different values. Each of the two zoom 
registers may be set to any value from 9 to 15 (@ corresponds 
to a zoom factor of 1, or default conditions). The X zoom 
and Y zoom registers may be set to different values, if 
desired. 


The lowest 4 bits of the ASCII characters <ZX> and <ZY> 
are used to set the zoom registers. Any printing ASCII 
characters can be used. The following table provides a 
sample list of characters which will produce good results. 


zoom Factor ASCII Character 


1 (default) @ 
2 A 
3 B 
4 C 
5 D 
6 E 
7 F 
8 G 
9 H 
16 I 
11 J 
12 K 
13 L 
14 M 
15 N 
16 (maximum) O 
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Examples: 
ESC Z BB 

Horizontal and vertical zoom factors are now set to 3. 
ESC Z @ @ 


Horizontal and vertical zoom factors are now set to l. This 
is the default condition. 


ESC Z @ D 


Horizontal zoom is now 1, and vertical zoom is now set to 5. 
The image on the CRT is "stretched" vertically. 
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Bitmap Roll and Page 


The Bitmap defaults to Page. This is most suitable for 
drawing images, since no part of the window is ever moved as 
new items are added to the image. 


If the Bitmap is to be used for extensive alphanumerics, 
Roll may be desirable. Roll is most suited for computer 
terminal applications. In Roll, as the last line of the 
window is filled with text, the top line "rolls" off the top 
of the window and is lost. To enter Roll, press the ROLL 
keys 


ROLL 
The key will illuminate, and the window is in Roll. 


To leave Roll and return to Page, use the SHIFT modifier 
with the ROLL key: 


SHIFT ROLL 


The lighted key will extinguish and the window is in Page 
mode again. 


The Bitmap is considerably slower than the Overlay when 
rolling data, since there are over a million pixels in Bitmap 
memory; a roll may move most of these pixels. Only the 
pixels within a given window are affected by a roll, however, 
so the smaller the window is defined to be, the faster the 
roll will occur (usually). 


The exception to this rule is when the window is defined 
to be the full Bitmap memory, 9, @ to 1023, 1923. (This is 
the default window size at power-up.) When the window is this 
Size, a fast hardware roll circuit is used to roll the 
Bitmap. However, this hardware roll takes place when text 
moves past the BOTTOM of Bitmap memory, and this area is 
normally invisible (unless Pan is being used). See "Overlay 
Roll and Page" for.more comments on this subject. 
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Rubber Band 
Formats: 
RUBBER BAND 


When the RUBBER BAND key is pressed, several things happen. 
The current cursor position, and the current foreground 
color, are memorized. The upper half of the Color Lookup 
Table (which contains all blinking color information) is 
saved, and reloaded with the current foreground color. Blink 
is disabled. The RUBBER BAND key lights up. . 


While Rubber Band is on, moving the cursor will cause a 
vector to be drawn from a previous cursor position to the 
current position. One end of this vector appears to follow 
the cursor, and "stretches" to meet the cursor; thus the 
name, "Rubber Band." The “rubber vector" is always drawn in 
whatever foreground color was in effect when Rubber Band was 
entered. (You may set a new foreground color while in Rubber 
Band, but this will affect the color of the figures you draw, 
NOT the color of the "rubber vector.”) 


While Rubber Band is on, you may be in any Plot Submode, 
Or in Alpha. Rubber Band will simply continue to draw 
vectors wherever the cursor goes. Every time a coordinate 
argument is entered, Rubber Band memorizes the cursor 
position and begins drawing the “rubber vector" from this new 
location. 


To leave Rubber Band, press: 


SHIFT RUBBER BAND 


The key will extinguish. The upper half of the Color Lookup 
Table is restored, and Blink is re-enabled. 


NOTE: 


Rubber Band requires that your image memory 
contain a plane number 7. If plane 7 does not 
exist in your system, Rubber Band cannot operate. 


Plane 7 is also the default Blink plane. It is not 
possible to use Rubber Band and Blink at the same 
time, unless Blink is assigned to another plane. 
Rubber Band may destroy any parts of a picture that 
were drawn with blinking colors. 
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Chapter 9 -- Plot Submodes 


This section describes the different Plot Submodes available 
for generating primitive figures. 


Each Submode is entered by pressing a key, such as CIRCLE, 
or entering a Plot code sequence. After entering a Submode, you 
may draw as many figures of that type as you wish, without 
retyping the original Submode key. , 


Each figure will require that you enter a certain number of 
coordinates or parameters. For example, each circle requires a 
set of X, Y coordinates for the center and a radius. After the 
first three parameters have been entered, the system has 
sufficient information to draw one circle, and it will proceed to 
do so. If three more numbers are entered, they will be 
interpreted as instructions to draw another circle. This process 
continues until the Submode is exited, by entering another 
Submode or by leaving Plot altogether (and returning to Alpha). 


As you will see in the examples, each argument given to a 
Plot Submode must be delimited. The delimiter may be a comma or 
a semicolon; either character is recognized as a valid delimiter. 
(The exception is for Polygons; you must use commas to separate 
each argument and terminate the argument list with a semicolon.) 
We suggest that a comma be used to separate numbers in a group 
(such as the three arguments which determine a circle), but that 
the semicolon be used to end the group. When organizing large 
volumes of numeric data, the group separators will be very 
useful. 


For the sake of Simplicity, in our examples, we have used a 


comma everywhere as a delimiter. The semicolon will be most 
useful when entering large amounts of data from a host device. 
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Figure o> |, 


DOT . 


TRIANGLE... . CURVE 


Plot Submodes (Primitives) 


teers 


VECTOR. . 
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Format: 
ARC <X>,<Y>, <R>, <start>, <delta>, 
Where: 


<X>,<Y¥>, are the coordinates of the center of the arc 
<R> is the radius of the arc 

Cebaets is the starting angle of the arc (degrees) 
<delta> is the number of degrees of arc to plot 


This software is optional, and may or may not be installed 
in your system. 


Arc submode will draw a part of a circle. The circle (of 
which the arc would be a part) is centered at <X>, <Y>. The 
arc is drawn from the angle specified by <start>, and will 
proceed for <delta> degrees. (The zero degree position for 
<start> is toward the right.) 


If the "Fill" attribute is currently on, the arc will be 
filled. This provides a quick way to draw "pie-chart" 
displays. : 


Example: 


SET YELLOW 
FILL 
ARC 511,383, 30, 30, 300, 


An arc will be drawn at the center of the screen, with 
radius 109. It will start at the zero-degree angle and 
proceed for 9@ degrees (ending directly above the center). 
This example draws a quarter of a circle. 


<start> and <delta> are always entered as integer degree 
values, and are unaffected by any scale factors in use. 


NOTE s 


This algorithm sacrifices accuracy for speed. Arc 
is accurate to one degree. 
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Circle 
Format: 
CIRCLE <X>, <Y>, <R>, 
Where: 
<X>,<Y>, are the coordinates of the center of the 
Circle 
<R> is the radius 


A circle will be drawn at the specified center coordinate 
<X>, <Y¥>, with radius <R>. The circle will be drawn in the 
currently specified foreground color. it “the. “Fill” 
attribute is currently on, the circle will be filled with the 
foreground color. 
Example: 

CIRCLE 511,383,100, 


would draw a circle centered at 5ll, 383, which is the 
center of the visible Bitmap area. The radius will be 18090. 


Alternate Format: 


CIRCLE . <R>, 


A circle will be drawn at the current cursor position > 
("Circle at this Point") with radius <R>. | 
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Two-point Circle 
Formats: 
‘PLOT O <X>,<Y>, <X1>,<Y1, 
Where: 
<X>,<Y>, are the coordinates of the circle's center 


<X1>,<Y1>, are used to set the radius of the circle 
| (see below) 


NOTE: 


The PLOT key used in this command is the key 
labelled MODE and PLOT, in the typewriter area of 
the keyboard. It is NOT the illuminated PLOT key 
in the upper keyboard area. 


The character "O" used in this function is the 
alphabetic, upper-case letter O and not_ the 
character zero. 


Two-Point Circle operates exactly like Circle, except that 
the radius is determined by the absolute value of either 
[X-X1| or |Y-Yl|, whichever is greater. The smaller number 
is ignored. 


The Two-Point Circle is most useful with certain input 
devices, like the Light Pen, which always send pairs of 
numbers. The Light Pen doesS not work with Circle since 
Circle requires three arguments. Two-Point Circle requires 
four arguments for each figure it draws, like most other Plot 
Submodes. | 


If the Fill attribute is on, the Two-Point Circle will 
be filled. 
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Curve 
Formats: 
CURVE <X1>,<Y1>, <X2>,<Y2>, <X3>,<Y3>, <X4>,<Y4)>, 


This software is optional, and may or may not be installed 
in your system. 


The Curve algorithm draws a figure called a Four-Point 
Bezier Curve. Each curve requires that four coordinates be 
entered. The four coordinates describe the curve as follows: 


<X1l>, <Y1l> (point 1) is the starting point for the 
curve, and the curve will pass through this point. 


<X4>, <Y4> (point 4) is the ending point for the 
curve, and the curve will pass through this point. 


<X2>, <Y¥2>, (point 2) and <X3>, <Y3> (point 3) are 
points which exert an "influence" on the curve. 
The curve will tend to be "pulled" toward these 
points, but will not usually pass through either of 
them. The curve is well-behaved, however, since 
the curve will always lie entirely within the 
polygon formed by drawing a line between the four 
points. 


At point 1, the curve will be tangent to the line 
from point 1 to point 2. 


At point 4, the curve will be tangent to the line 
from point 3 to point 4. 
Example: 
CURVE 0,0, 9,767, 1923,9, 1923,767, 
This example draws a curve which begins at the upper left 


corner of the screen and ends at the lower right corner. The 
other two corners "pull" the curve into an S-shape. 
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Alternate Format: 
CURVE . . .« 


The cursor position may be used to specify coordinates. For 
each coordinate pair, move the cursor to the desired location 
and strike the period (decimal point) key. 


The curve function is well suited to human interaction. 
Very complex figures can be designed by linking together some 
Simple curves. Since the curve is always well-defined at its 
end points, it is possible to join two or more curves 
perfectly. This is done by arranging point 4 of one curve to 
be the same as point 1 of the next, and making points 3 and 4 
of one curve collinear with point 2 of the next. 


NOTE: 


Since Curve uses a recursive algorithm, points may 
not always join perfectly due to roundoff error. 
This could be disastrous when using a Complex Fill 
mode. 


Curve points MUST always lie within the scaled 
screen boundaries. | 
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Dot 


Format: 
DOT <X>,<Y>, 


To initiate the Dot submode, hold down the SHIFT key and 
press the key labelled DOT and VECTOR. After each pair of 
coordinates is entered, a single dot will be placed on the 
screen, in the currently specified foreground color. 


Example: 
DOT 511,383, 


This will place a dot in the center of the visible Bitmap 
screen. A Single dot is very small, and may be difficult to 
see. 


As with all Plot Submodes, now that we have entered the 
Submode we can enter more information and additional figures 
will be drawn. In DOT Submode, a single dot will be placed 
on the screen every time we enter another pair of <xX>, <Y>, 
coordinates. | 


Alternate Format: 
DOT . 
A single dot will be placed on the screen under the cursor. 


It will be necessary to move the cursor in order to see the 
dot. 
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Incremental Vector 
Format: 
INC VECTOR <X>,<Y>, [<dX><dY>...] 
Where: 


<X>,<Y>, are the starting coordinates for the set of 
short vectors, | 


<dX><dY> are single characters (NOT numbers) which 
determine the displacement in the xX and Y 
directions. Note that no commas are used to 
separate <dX> and <dY>. 


Incremental vector draws a short vector from the point <X>, 
<Y>. The length and direction are determined by the 
Characters <dX> and <dY>. The bits of <dX> determine a 
displacement in the X direction, up to plus or minus 31 
pixels. <dY> does the same in the Y direction. 


If more <dX> and <dY> characters are entered, more short 
vectors will be drawn and will be concatenated with previous 
Short vectors. 


The bits in <dX> and <dY> are interpreted as follows: 


7 6 5 4 3 2 1 4) 
fom m tenn tenn tenn te nn tanto nant nt 
ee. Sue ee a ee a 
fmt nt nth tt rete nn tent t 

oeee eMagnitude..... 


The state of bit 7 is ignored. Bit 6 must be al. Bit 5 is 
a Sign bit, @ for a positive displacement and 1 for a 
negative displacement. Bits 4 through 9 are used as a 5-bit 
magnitude, capable of specifying numbers up to 31. Negative 
numbers are NOT interpreted in two's complement form. 
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The following table illustrates the displacement 
corresponding to each ASCII character. Note that since bit 6 
is always set to 1, the characters used for <dX> and <dY> 
will always be in the printable ASCII set. No 
control-characters are used (except DEL). 


Binary ASCII displacement Binary ASCII displacement 
1900009 @ 4) 11999090 i 4) 
1900001 A 1 1190001 a -l 
19890019 B 2 1199619 b -2 
1969811 C 3 1190811 Cc -—3 
1900198 D 4 11981990 d —4 
19801981 E 5 1199191 e =5 
1000119 F 6 1199119 f —6 
1808111 G 1 1199111 g -7 
1601800 H 8 11919900 h -§ 
19619801 I 9 1191901 i —9 
19019190 J 19 11981919 5 -10 
1981811 K 11 1191811 kK -l11 
18811990 L 12 1191199 1 -12 
1901101 M 13 1191191 m -13 
1991119 N 14 1191119 n -14 
1991111 O 15 11@1111 O ~15 
1810090 P 16 1119009 p -16 
1910061 Q 17 11169001 q -17 
1919019 R 18 1110019 r -18 
19189011 S 19 1119011 iS -19 
1919199 T 20 1119190 t -20 
1619191 U 21 11191901 u -21 
1919119 V 22 1114119 V -22 
1919111 W 23 1119111 Ww -23 
1911999 X 24 1111999 x -24 
1911901 © Y 25 1111961 y “25 
1911919 Z 26 1111919 Z -26 
1@11911 [ 27 11119811 { -27 
1911109 \ 28 1111199 | —28 
1911191 ] 29 11111901 } -29 
1911119 . 3G 1111119 a -30 
1911111 = 34 1111111 DEL -31 
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Examples: 
INC VECTOR 511,383,D E 


The displacements for ASCII characters D and E are +4 and 
+5, respectively. A vector will be drawn from the point 5ll, 
383, to a point 4 pixels to the right and 5 pixels below the 
Original point. Note that a positive Y-displacement moves 
DOWN the screen since the Y=@ line is at the top. 


INC VECTOR 699,499,D E De 


This set of short vectors begins at the point 600, 480. The 
first vector will be drawn from this point, 4 pixels to the 
right, and 5 down. A second vector will follow, 4 to the 
right and 5 up (the displacement for the e character is -5). 
So the end point of the set has the same Y coordinate it had 
at the beginning, but its X coordinate is shifted 8 to the 
right. 


INC VECTOR. JA 


The cursor position may be used to enter the initial 
coordinate of the set. To use this format, position the 
cursor to the desired location and strike the decimal point 
key to enter the cursor position as a coordinate pair. Then 
enter the ASCII character displacements as before. 
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Incremental X-Bar 
Formats: 


INC X—BAR <X@>,<Y@>,<X1>, [<X2>,<X3>,...] 


Where: 
<XO>,<YO> are the coordinates of one endpoint of 
the first bar 
<X1> is the X-coordinate of the other endpoint 
of the first bar (the previous 
Y-coordinate is used as a reference -- see 
below) 


<X2>,<X3>,.-e. are X-coordinates of the endpoints of 
| subsequent bars (see below) 


A horizontal bar (actually a rectangle) is drawn, with 
corners located at <X@>, <Y@>, and <X1>, <Y@>+<w>. The 
default value of <w> is 3. The value of <w> may be altered 
by the "Set Vector Width" command. If the "Fill" attribute 
is currently on, the bar will be filled. 


After the first bar is drawn, more X-coordinates may be 
entered. Additional bars will be drawn adjacent to the 


existing ones. The effective coordinates for the corners of 
each bar are: 


<XO>, <Y¥@> + (n-1l)<w> for one corner, 
<Xn>, <Y@> + (n)<w> for the diagonally opposite corner, 


where n is the bar number (n=l for the first bar). 
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Example: 
INC X-BAR 511,190, 611, 711, 811, 


Three bars are drawn. Each will be drawn from the vertical 
line X=5ll to the required X-coordinate. The first bar will 
begin at the horizontal line Y=100, and will extend to the 
line Y=1@4. The next bar will be drawn from Y=195 to Y=109. 
As many additional xX-coordinates may be entered as you 
require. 


This time four bars are drawn. Notice that the bars may be 
drawn either to the right or left of the original Y=<Y@> 
line. _ 


If desired, the decimal point may be used to enter the 
cursor poSition for each point. The first time the decimal 
point is pressed, it will enter the initial <xX@>, <Y@> 
position. Each subsequent time the decimal point is pressed, 
the X-coordinate will be taken from the current cursor 
position (the Y-coordinate will be discarded). 
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Incremental Y-Bar 
Formats: 


INC Y-BAR <X@>,<Y@>,<Y1>, [<Y2>,<Y3>,...] 


Where: 
<XO>,<YO> are the coordinates of one endpoint of 
the first vector 
<Y1> is the Y-coordinate of the other endpoint 
of the First vector (the previous 
X-coordinate is used as a reference -- see 
below) 


<Y¥2>,<Y¥3>,.-- are Y-coordinates of the endpoints of 
subsequent vectors (see below) 


Operation is identical to Incremental X-Bar. Vertical bars 
are drawn with width <w>, set by the "Set Vector Width" 
command. The default value of <w> is 3. if the "Fill" 
attribute is currently on, the bar will be filled. 


The diagonal coordinates of the first bar are <X@9>, <Y@> 
and <X@>+<w>, <Y1l>. If additional Y-coordinates are entered, 
more bars will be drawn. The effective coordinates for each 
bar are: 


<XO> + (n-1)<w>, <Y@> for one corner, 
<XO> + (n)<w>, <Yn> for the diagonally opposite corner, 


where n is the bar number (n=1 for the first bar). 
Example: 
INC Y-BAR 9,383, 300, 200, 100, 200, 399, 


Five vertical bars will be drawn, in ae histogram-type 
format. 


If desired, the decimal point may be used to enter the 
cursor position for each point. The first time the decimal 
point is pressed, it will enter the initial <xX@>, <Y@> 
position. Each subsequent time the decimal point is pressed, 
the Y-coordinate will be taken from the current cursor 
position (the X-coordinate will be discarded). 
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Polygon 
Formats: 
POLYGON <X1>,<Y1>,<X2>,<Y2>, [<Xn>,<Yn>,...] ; 


This software is optional, and may or may not be installed 
in your 799098 system. If Polygon is not installed, a polygon 
may be drawn with concatenated vectors and filled with AREA 
FILL, if needed. 


Polygon draws a set of concatenated vectors, defined by 
the coordinate pairs <X1l>, <Y1>, through <Xn>, <Yn>. The 
endpoint of the last vector is joined to the first vector, to 
form a closed polygon. Up to 38 coordinate pairs may be 
entered. (If you need more than 38 points, use "Large 
Polygon," described on the next page.) 


The semicolon MUST be entered after the final coordinate 
pair, to Signal that all the coordinates have been entered 
and that drawing should now begin. NOTHING IS DRAWN until 
the semicolon is entered. 


When entering coordinates in standard decimal form, as 
in the format above, the last coordinate pair must be 
terminated by a comma and then by the required semicolon. 


Example: 


The polygon is drawn from the origin (upper left corner of 
the screen) to the center of the screen, to the upper right 
corner, to the center of the bottom. The final vector 
connects the center bottom to the origin. 


Note that the final product is very similar to a set of 
concatenated vectors. But Since all the coordinates are 
entered before drawing begins, the object appears to be drawn 
much faster. 


Alternate Format: 
POLYGON .~. .« © ce eee } 


The cursor position may also be used to specify coordinates. 
The cursor should be moved to each point where a vertex of 
the polygon is desired. The decimal point key should then be 
Struck at each point. After all points have been entered in 
this manner, the final semicolon must be entered. | 
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The polygon will be filled if the Fill attribute is 
active. Filled polygons are drawn somewhat differently than 
unfilled figures, but the result is the same. 


Large Polygons 
Format: 
ESC P <X1>,<¥1l>, <X2>,<Y2>, wee ; 


The Large Polygon command must be used for figures with more 
than 38 points. It is independent of windows and assignable 
devices. It can be used the same way as the normal POLYGON 


command, except that the dot (.) cannot be used to enter 
coordinates. 


The default size limit for Large Polygon is 259 
coordinates. The Thaw parameter EscArgZ controls this limit 
and may be altered using THAW. Allow 4 bytes per coordinate 
plus room for 1 extra coordinate. 


NOTE: 


The fill attribute of window 8 is used with Large 
Polygon. 
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Ray 
Format: 
RAY <X>,<Y¥>, <R>, <angle>, 
Where: 
<X>,<Y>, are the coordinates of one end of the ray 
<R> is the length of che ray 


<angle> is the angle from <X>,<Y> at which the ray is 
drawn. 


This software is optional, and may or may not be installed 
in your system. 


Ray submode draws a vector in polar form. The origin of 
the vector is specified as an <X>, <Y> coordinate pair. The 
length and direction are then specified, which determine the 
other end point of the vector. 


Example: 
RAY 511,383, 100, 45, 


A ray will be drawn from the center of the screen, toward 
the upper right quadrant, at an angle of 45 degrees. If this 
example is executed after the Arc example in the previous 
section, it will divide the 98 degree arc into two 45 degree 
segments. | 


One application for Ray is the development of 
"pie-chart" graphs. Ray allows the programmer to subdivide a 
Circle into any desired segments, simply by entering the 
angle in degrees. (The <angle> is always entered in integer 
degrees, and is not affected by any scale factors in use.) 
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Rectangle 
Format: 
RECT <X1>,<Y1l>, <X2>,<Y2>, 


A rectangle will be drawn whose opposite corners are located 
at <X1l>, <Y1>, and <X2>, <Y2>, in the currently specified 
foreground color. If the "Fill" attribute is currently on, 
the rectangle will be filled with the foreground color. 


Example: 
RECT 9,0, 511,383, 


would draw a rectangle around the upper left quarter of the 
screen. 


Alternate Format: 

RECT .. 
The cursor position is used to specify the opposite corners 
of the rectangle. The cursor should be moved to the desired 


locations and the decimal point struck at each location 
("Rectangle from this Point to this Point"). 
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Triangle 
Format: 
TRIANGLE <X1>,<Y1>, <X2>,<Y2>, <X3>,<Y3>, 


A triangle will be drawn between the three specified points, 
in the currently specified foreground color. If the "Fill" 
attribute is currently on, the triangle will be filled with 
the foreground color. 


Example: 

TRIANGLE @,@, @,383, 511,383, 
will draw a triangle from the upper left corner, vertically 
halfway down the screen, to the center of the screen, and 
return to the starting point. 
Alternate Format: 

TRIANGLE .. .« 
The cursor position may be used to specify coordinates. The 
cursor should be moved to each location where a vertex of the 
triangle is desired, and the decimal point struck at each 
location ("Triangle from this Point to this Point to this 
Point"). 
NOTE: 


For filled triangles, use POLYGON if your system 
has it. It is faster and more accurate. 
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Vector 
Format: 


VECTOR <X1>,<Y1>, <X2>,<Y2>, 


Where: 


<X1>,<Y1>, are the coordinates of one end of the vector 
<X2>,<Y2>, are the coordinates of the other end 


A vector will be drawn from point <Xl1>, <Y1>, to point <X2>, 
<Y2>, in the currently specified foreground color. 


If additional pairs of points are entered, a new vector 
will be drawn between them. The new vector will not be 
connected to the first one (See Concatenated Vector). 


Example: 
VECTOR 9,9,511,383, 


A vector will be drawn from the 9, @, position (the upper 
left corner) to the center of the visible screen. 


Alternate Format: 


VECTOR. . 


The decimal point may be used to enter coordinates. The 
Cursor control keys should be used to move the cursor to the 
desired end points of the vector, and the decimal point 


should be struck once at each point ("Vector from this Point 
to this Point"). | 
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Concatenated Vector 
Formats: 
CONCAT VECTOR <X1>,<Y1>, <X2>,<Y2>, [<X3>,<Y3>,...] 


Where: 


<X1>,<Y1>, are the starting coordinates of the set of 
concatenated vectors 


<X2>,<Y2>, are the coordinates of the endpoint of the 
first vector in the set 


<X3>,<Y3>, and all other coordinates, are endpoints of 
Subsequent vectors in the set 


A vector will be drawn from <Xl>, <Y1>, to <X2>, <Y2>, and 
another connected vector from <X2>, <Y¥2>, to <X3>, <Y3>, and 
so on. Each additional coordinate entered will cause a new 
vector to be drawn from the endpoint of the previous vector. 


Example: 

CONCAT VECTOR 9,8, 511,383, 1923,9, 1823,767, 
A vector will be drawn from the upper left corner, to the 
center, to the upper right corner, to the lower right corner. 
Any number of additional points could be added. 
Alternate Format: 


CONCAT VECTOR « « « « coe 


The decimal point may be used to enter coordinates. The 
cursor should be moved to each location where a vector 
endpoint should lie, and the decimal point struck at each 
location. ("Concatenated Vector from this Point to this 
Point to this Point...") | 


NOTE: 


If you wish to terminate one set of concatenated 
vectors and begin another set, you must hit the 
CONCAT VECTOR key again. 
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Bold Vector 
Format: 
PLOT v <X1>,<Y1>, <X2>,<Y2>, 


This software is optional, and may or may not be installed 
in your 79990 system. 


NOTE: 


The PLOT key used in this command is the key 
labelled MODE and PLOT in the typewriter area of 
the keyboard. It is NOT the lighted PLOT ney in 
the upper keyboard area. 


This command requires entering a lower’ case 
letter, v. If the ALPHA LOCK key is in its normal 
(up) position, hold down the SHIFT key while 
pressing the "V" key to produce a lower case v. 


Operation is identical to Vector, except that a bold vector 
is drawn whose width is determined by the "Set Vector Width" 
command. The bold vector has rounded ends, produced by 
drawing small circles at each end of the vector. This makes 
connected bold vectors smoother (see "Concatenated Bold 
Vector" on the next page). 


The value of <w> given by the "Set Vector Width" command 
is used aS a radius for the circle at each end of the bold 
vector. Thus, the actual width of the bold vector is twice 


<w> plus one. If <w> is zero, a normal (not bold) vector is 
drawn. 
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Concatenated Bold Vector 
Formats: 
PLOT w <X1>>,<Y1>y<KX2>9<Y2> 5 (<XN p<KYDO pee | 


This software is optional, and may or may not be installed 
in your 7998 system. 


NOTE: 


The PLOT key used in this command is the key 
labelled MODE and PLOT, in the typewriter area of 
the keyboard. It is NOT the illuminated PLOT key 
in the upper keyboard area. 


This command requires entering a lower case 
letter, w. If the ALPHA LOCK key is in its normal 
(up) position, hold down the SHIFT key while 
pressing the "W" key to produce a lower case w. 


Operation is identical to Concatenated Vector, except that a 
series of bold vectors is drawn. See the description of Bold 
Vector on the previous page. 
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Set Vector Width 
Format: 
V. WIDTH <w>, 
Where: 
<w> is a decimal number, 9 to 65535 
NOTE: | 
V. WIDTH is a Single key. The name "V. WIDTH” is 


printed on the front of the SIZE key. 


This command affects the Incremental X-Bar and 
Incremental Y-Bar Plot Submodes. It also sets the vector 
width for the optional "Bold Plotting" software routines. 


When a wide vector is required, the most’ recently 
Specified value of <w> is used. The default value of <w> is 
3. If <w> is @, normal (thin) lines will be drawn. 


The value of <w> is specific to a window; each window 


may have itS own vector width defined. If <w> has not been 
defined in a window, the default value will be used. 
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Vector-Drawn Characters 
Formats: 


PLOT E <angle>, <flag> 


Where: 


<angle> is a decimal angle, in degrees 


<flag> is the character 1, or 6, to indicate whether 
proportional spacing should be used 


NOTE: 


The PLOT key used in this command is the key marked 
with MODE and PLOT labels, on the typewriter area 
of the keyboard. It is NOT the lighted PLOT key in 
the upper keyboard area. 


This software is optional, and may or may not be installed 
in your system. 


Vector-drawn characters may be drawn at any angle. The 
characters are drawn uSing bold vectors. After entering the 
command to begin this Plot Submode, you may enter characters 
normally and they will be plotted on the Bitmap screen. 


The "Set Character Size" and "Set Vector Width" commands 
may be used to set up the characters for your application. 
In addition, since the vector-drawn characters use an 8 by 12 
matrix (instead of the normal 6 by 8), the “Set 
Intercharacter Spacing". command may be used to adjust the 
system for a larger character font. An appropriate setting 
is MODE I 8, 12, when proportional spacing is NOT in use. 


The vector-drawn characters are always in "overstrike" 
mode. There is no way to backspace, erase, or otherwise 
perform text editing functions on these characters. It is 
recommended that this character set be used primarily from a 


program or a host system, so that backspacing will not be 
required. 
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Example: 


PLOT E 9, 1 


SIZE 4, 4, 
MOVE X-Y 19, 190, 


This is a test 


Plotted characters, angle of = zero 
degrees (horizontal) , proportional 
Spacing ON 

Character size 4 X 

Move cursor out in the open 


Type in some text. 


If you wish the text to come out "mirrored" upside-down 
Or backwards, you can specify a negative number in the SIZE 
command. The arrow keys will move backwards too, depending 
on whether X or Y size is negative. See the example below. 


Example of Yector-drawn characters 
Using fumny numbers for Size, Each 


string was typed as "RATS" 


Size 3,3, 


Size ~-3,3, 


RATS = OTA 


Stile Bo ( 


Size 3,-~3 
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Exiting Plot Submodes 


Any time you enter a Plot Submode, the light on the PLOT 
key will come on. This light indicates you are in a Plot 
Submode. Pressing a different Plot Submode key will change 
the Submode you are in, but the lighted PLOT key will remain 
lit whenever you are in a Plot Submode. 


To return to Alpha (text entry), type 
SHIFT PLOT | 
Hold down the key marked SHIFT, and press the lighted key 


marked PLOT. The light will go out, and you are out of 
whatever Plot Submode you were in. You are back to Alpha. 


To resume plotting, you may simply press any Plot 
Submode key, as you originally did to begin plotting. You 
can also re-enter the last Plot Submode you were uSing, by 
pressing the lighted PLOT key (without the SHIFT modifier). 
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Chapter 19 -- Raster Processor Graphics 


The software described in this section is optional, and may 
Or may not be installed in your 7999 system. 


The Raster Processor is a special circuit in the 7990 
hardware. Its main function is to move pixels from one area of 
the Bitmap screen to another. The functions described in this 
section make use of some of the capabilities of the Raster 
ProceSSOr. 


Besides the "block move" capability of the Raster Processor, 
you can use the text editing commands on the four arrow keys (INS 
LINE, DEL LINE, INS CHAR, DEL CHAR) to move parts of the screen 
around. For example, if you did not leave enough room at the top 
of the screen to draw something, you could move the cursor into 


this area and use the INS LINE key to push everything below the 
cursor down. 


For the purposes of this chapter, we define a "raster" to be 
a block of Bitmap pixels. 
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Define Source Raster 
Format: 
MODE [ <Xl>, <Yl1>, <X2>, <Y2>, 


Where: 


<X1>,<Y1>, are the coordinates of one corner of the 
desired source raster 


<X2>,<Y¥2>, are the coordinates of the diagonally 
opposite corner 


A "raster" is a rectangular area of the Bitmap screen. The 
Raster Processor operates only on these rectangular areas. A 
"Source raster" is defined exactly as you would enter the 
corner points of a rectangle, and all the pixels within this 
area are used in the commands which are discussed later in 
this section. 


The source raster definition is specific to a window. 
Each window may have itS own source raster defined to be a 
different area of the screen. 


Note that the offscreen Bitmap area (the pixels not 
normally visible unless Zoom and Pan are in effect) may be 
used to store source rasters. 


The definition of a source raster contains only the 
screen location of the raster, not the pixels within it. If 
a source raster is defined, and the pixels within that area 
are altered, the source raster is also altered. 

Alternate Format: 

MODE [ . ° 


The current cursor position may be used to enter the X-Y 
coordinates of the source raster, by moving the cursor to 
each corner and striking the period (decimal point) key. 
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Copy Raster 
Format: 
COPY <X>, <¥>, 
Where: 


<X>, <Y¥> are the coordinates to which the raster 
Should be copied. 


A copy of the source raster is made at screen position <X>, 
<Y>. This may be thought of as a "rubber stamp” operation. 
The cursor position may be used instead of <X> and <Y>:; 


COPY . 
This command copies the source raster to the current cursor 
position. 
Example: 
SHIFT OVERLAY (look at Bitmap) 


HOME A B C D RETURN LINE FEED 


EF GH (put some characters in 
upper left corner of screen) 


MODE [ 9, 9, 48, 32, (define the source raster to 
be these characters) 


COPY 511, 383, (copy raster to the center 
of the screen) 
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Copy Raster with Overstrike 
Format: 
MODE u <X>, <Y>, 
Where: 


<X>, <Y¥> are the coordinates to which the raster 
should be copied. 


NOTE: 


This command requires entering a lower case 
Character, u. If the ALPHA LOCK key is in- its 
normal (up) position, press the SHIFT key with the 
"U" key to produce a lower case u. 


This command is identical to the "Copy Raster" command, 
except that any pixels in the source raster matching the 
Current background color are not written. 

The cursor position may be used instead of <X> and <Y>: 


MODE u . 
This command copies the source raster to the current cursor 


position, using overstrike. It is slower than copying 
without overstrike, since the CPU gets involved. 
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Set Raster Direction 
Format: 
MODE { <n>, 
Where: 


<n> is a decimal number, 27 through 3l 


NOTE: 


This command is only applicable to the Copy Raster 
commands. 


The Raster Processor uses a "control byte" to set the 
attributes of the source and destination rasters. This 
command allows you to modify the attributes of the source 
raster definition. Internally, the Raster Processor defines 
a raster by using a coordinate pair (called the "operating 
point"), a value for delta-X, and a value for delta-yY. 
Whenever the Raster Processor copies a raster, it begins at 
the operating point and performs operations determined by 
delta-X, delta-Y, and the control byte. 


The bits in the control byte are defined as follows: 


Bit No. 4 3 2 1 @g 


All other bits are unused. 


XS is X Sign. If SET, the raster is scanned from 
left to right. 


YS is Y Sign. If SET, the raster is scanned from 
top to bottom. 


XF is X Fine. If SET, X is incremented first as 
the raster is scanned. When X overflows (becomes 
greater than delta-X), Y is incremented and X is 
set to itS original value from the operating point. 
If this bit is CLEAR, Y is fine and is incremented 
first. 
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EC and ES are Enable Carry and Enable Step, 
respectively. If these bits are CLEAR, the Raster 
Processor does not increment certain registers. 
This prevents the entire raster from being scanned. 
This is not a useful condition, since the same 
effect can be achieved by defining the source 
raster to be one line (or one pixel). When using 
the Set Raster Direction command, you should leave 
these two bits SET. 


The default value for <n> is 31. This corresponds to. all 
bits SET, resulting in normal upright raster copies. 


The illustration on the following page should help to 
clarify use of the Set Raster Direction command. Assume we 
have created a test pattern, consisting of a square 
containing a letter, and defined it to be the source raster. 
We chose the letter R because it is not symmetric about any 
axis, and rotation can be easily observed.) 


Now if a Copy Raster command is executed, the square will 
be copied to the specified location. The control byte is now 
31 (default), so an upright copy is generated. 


If the X Fine bit is now cleared by performing a MODE { 
38, the copy will be reflected about the 45 degree axis. 
(For this to work properly, the source raster MUST be 
square!) 


If the Y Sign bit is now cleared by performing a MODE { 
29, (this also SETS the X Fine bit), the raster will be 
copied upside-down and backwards. 


Other combinations of these three bits will produce the 
other raster copies shown. 
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Patterned Vectors 


Formats: 


MODE T <pattern> <clip> 


This 


command enables patterned vectors with or without 


Clipping. Both <pattern> and <clip> can be either 1 or @. 


For <pattern>, if a 1 is entered, patterned 
vectors are used for ALL Bitmap graphics functions, 
including vectors, circles, arcs, etc. The current 
source raster is used as a source for the pattern. 
While patterned vectors are active, the pattern is 
used INSTEAD of the current foreground color for 
all graphics operations. Entering a 9 disables 
patterned vectors. 


When <clip> is 1, all lines and points drawn will 


be clipped to lie within the boundaries of the 
current window. 


This command can be cancelled by the command MODE O l 
(Overlay ON) or by hitting the OVERLAY key. 


Example: 


SHIFT OVERLAY (look at Bitmap) 


HOME A B C D RETURN LINE FEED 


EF GH : | (put some characters in 
upper left corner of screen) 
MODE [ 0, @, 48, 32, (define the source raster to 
be these characters) 
MODE Til @ (patterns ON, clipping OFF) 
CIRCLE FILL 511, 383, 3900, (draw patterned circle) 
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Chapter ll -- Expanded Image Memories 


The commands in this section apply to CGC 7908 systems 
containing two banks of image memory planes. 


As mentioned in the introduction to Section 3, the 7989 may 
be equipped with up to 16 planes of image memory. ° Only 8 planes 
at one time may feed the Color Lookup Table to form an image, but 
two independent images may be kept in memory Simultaneously. The 
commands in this section provide access to the second set of 
image planes. 


Select Image 
Format: 
ESC s <@ or 1> 
Use the character 9 to select planes @ through 7 for display 


(the default condition), or the character 1 to select the 
second image, planes 8 through lL5. 


NOTE: 


This command requires entry of a lower case 
letter, s. If the ALPHA LOCK key is up, use the 


SHIFT modifier with the "S" key to produce a lower 
case s. 


If planes 8 through 15 are not instalked in your system, 
selecting planes 8 through 15 will cause the the Bitmap 
screen to go blank. 
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Plane/Video/Blink Select 


These commands are described later in this chapter, but 
take on new meanings when more than 8 image planes are 
installed. They are: Plane Select, Plane Video Switch, and 
Blink Select. 


Each of these commands requires entering a decimal 
number to enable selected image planes in a particular 
function. With only 8 image planes, the useful range of 
numbers is @ to 255; this allows writing to any or all of the 
8 planes. (255 is the highest decimal number possible from 
an 8 bit, or 8 plane, system.) 


With up to 16 planes installed, the useful range of 
numbers for these commands increases to a 16-bit number. 
This allows values from @ to 65535. 


Examples: 


MODE : 255, Planes 9 through 7 are selected 
(write-enabled) 

MODE : 65280, Planes 8 through 15 are selected 
(65535 - 255 = 65280) 

ESC b 32896, Planes 7 and 15 are specified to 
blink (2°15 + 2°7 = 32896) 

ESC S 771, | Video from planes @, 1, 8 and 9 


is enabled for displa 
(2°90 + 271 + 2°8 + 2°9 = 771) 


Obviously, the numbers can get out oof hand quickly. 
Calculation of plane numbers in a l6-plane system iS more 
Suited to an applications program. 


The decimal number -l may still be entered, and it will 
always enable all planes in the system. 
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Writing to the Second Image 


The following example demonstrates how to create two 
independent images. 


ESC s @ View the first image (planes §-7) 
MODE : 255, Write-enable the first image 


CIRCLE FILL SET BLUE 511,383,30@, Draw a blue circle 
in the first image 


ESC s l View the second image (planes 8-15) 
MODE : 65280, Write-enable the second image 


RECT SET RED 100,100,799 ,3900, Draw a red rectangle 
in the second image 


Now, the command ESC s @ displays a blue circle, and ESC s l 
displays a red rectangle. 


Note that the default cursor color is color 135 
(blinking white), so the Bitmap cursor will not be visible 
when planes 8 through 15 are being displayed. To make the 
cursor appear in all planes, and thus in both images, use 


NOTE: 
When using a- second image, be sure to set the 


Plane/Video/Blink select latches to the appropriate 
configuration before use. 
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Plane Select 
Format: 
MODE : <n>, 
Where <n> is a number, 9 to 255, or -l. 


<n> iS examined as a binary number. Any bits in <n> 
which are set to one represent planes of Bitmap memory which 
will be write-enabled. Any bits in <n> which are zero 
represent planes which are not write-enabled, and cannot be 
altered until the next Plane Select command is given. fThis 
command only affects the window which receives it. 


Examples: 


MODE : @, 
Since all bits of the number @ are zero, all planes of 
Bitmap memory are now write-disabled. They cannot’ be 
altered. 

MODE : 6, 


The number 6 is converted to a binary number, and examined 
as follows: 


Plane # 7 6 5 4 3 2 l 4) 
fm ep a ee ae a ae ef a 
| @l|ot|ot|l|l@oetoetitlti1t{t@ii 
fm ep a a an oe a a a et ee 


Since bits l1 and 2 are ones, only planes 1 and 2 of Bitmap 
memory can now be altered. The other planes will be 
unaffected by any commands or characters sent to the window. 


Example: 
MODE : -l, 


Negative numbers are treated in “two's complement" form. 
Negative one is treated as a binary word of all ones, so all 
planes are now write-enabled. This is the default condition 
when the system is booted. 
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Plane Video Switch 
Format: 
ESC S <n>, 
Where <n> is a number, 8 to 65535, or -l. 


<n> is examined as a binary number. Any bits in <n> 
which are set to one represent planes of Bitmap memory which 
will be allowed to feed the Color Lookup Table. Any bits in 
<n> which are set to zero will prevent their corresponding 
planes of Bitmap from feeding the CLU. 


NOTE: 


This command affects ALL images from Bitmap 
memory. It is NOT specific to a window. 


Example: 
ESC S 6, 


All bits in the number @ are zero. All planes of Bitmap 
memory will not be fed to the Color Lookup Table (their bits 
will be masked to zero). Thus, the only color of the CLU 
which will be accessed is color zero (normally black). We 
have just shut off all image from Bitmap memory. 


Example: 
ESC,S 5, 
The number 5 is examined as follows: 
Plane # 7 #6 5 4 3 2 «21 «@ 
hoa tant entrant tant 


| d@l1o1]ototstotitsésti1 i 
fon n tant ett $4 +--+ 
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Since bits @ and 2 are set to one, only planes 9 and 2 
will be allowed to feed the Color Lookup Table. All other 
planes will be masked to zero before being used to select 
colors. This configuration allows the following color 
choices: 


Color ®@ (all bits off) 
Color 1 (bit @ on) 

Color 4 (bit 2 on) 

Color 5 (bits @ and 2 on) 


Under default conditions, these four colors would correspond 
to Black, Blue, Red, and Magenta, respectively. 


It can be seen from this example that the Plane Video 
Switch command limits the available color choices. The total 
number of choices which are available is 2 raised to the 
power <b>, where <b> is the number of bits set to one in the 
number <n>. In the example above, <n> is 5, which contains 
two bits (<b>) set to one. Two to the power two is four, the 
total number of colors we have made available. 


Example: 


Negative numbers are interpreted in “two's complement" form. 
Negative one is a binary word of all bits set to one, so this 
command will set all planes to feed the Color Lookup Table. 
This is the default condition when the system is booted. 


A primary use for the Plane Video Switch command would 
be animation. Different pictures could be written to the 
various planes (using Plane Select, previously described), 
and then the system could guickly switch from one picture to 
another with Plane Video Select. The Color Lookup Table 
might have to be modified for best results. 


Another use would be the layout of multiple-layer 
printed circuit boards. Each layer could be written into a 
Single plane of Bitmap memory. Areas which overlapped would 
reference different areas of the Color Lookup Table, and 
would be displayed as different colors. The Plane Video 
Switch command would allow viewing each layer of the board 
separately. 
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Appendix A -- Special Codes 


For the sake of clarity, the names of modifier keys are not 
underlined in this section. Remember, however. that 
control-codes are always generated by holding the CTRL key and 
Simultaneously pressing the indicated key. 


Control Codes 


CTRL @ Null 

CTRL A Mode 

CTRL B Plot 

CTRL C 

CTRL D 

CTRL E Dot Up 

CTRL F 

CTRL G Bell 

CTRL H Backspace 

CTRL I Tab 

CTRL J Linefeed 

CTRL K Cursor Up (Line) 

CTRL L Erase Page 

CTRL M Carriage Return 

CTRL N A7 On (Alternate Character Set) 
CTRL O A7 Off (Standard Character Set) 
CTRL P 

CTRL Q X-On 

CTRL R 

CTRL S X-Off 

CTRL T 

CTRL U User 

CTRL V Dot Down 

CTRL W 

CTRL X End Of Record (Sub-Buffer marker) 
CTRL Y Dot Left 

CTRL Z Cancel (Flush input buffer) 
CTRL [ Escape 

CTRL \ Home 

CTRL | Cursor Right (Char) 

CTRL ~* End Of File 

CTRL _ Dot Right 
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Mode, Escape and User code sequences may have one or more 
arguments. The type of argument required is indicated as 


follows: 

# =a decimal number terminated by a comma, or a 
binary number (if in binary mode) 

XY an X-Y coordinate pair. It may be either the 
period (.) or two decimal numbers ("“##" as 
described above) 

F the character 1, or @, used as an on/off flag 

n a Single digit (@ through 9) 

C a Single character (details depend on the 


command) 


Colors are described as #, since they may be entered as 
numbers. 
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Mode Codes 
Mode codes always begin with the MODE character, CTRL A, 
@1 hex. 
MODE : # Plane Select 
MODE 3; 
MODE < 1 Delete Character 
MODE < 2 Delete Line 
MODE = Soft Boot 
MODE > 1 Insert Character 
MODE > 2 Insert Line 
MODE ? Keyboard Sync 
MODE @ Clear line 
MODE A 
MODE B F Binary Mode (MODE and PLOT codes) 
MODE C # Set Foreground color 
MODE D 
MODE E F Rubber Band on/off 
MODE F F Fill on/off 
MODE G 
MODE H = 
MODE I ## Set Bitmap intercharacter spacing 
MODE J F Cursor on/off 
MODE K F Blink on/off 
MODE L | 
MODE M XY Move cursor to xX-Y 
MODE N 
MODE O F Overlay on/off 
MODE P F Plot on/off 
MODE Q # Set Cursor color 
MODE RF Roll on/off 
MODE S F Scale on/off 
MODE T nn set vector type 
MODE U XY Copy raster to X-Y 
MODE V n Set Overlay present visibility 
MODE W XY XY Define Window limits 
MODE X ## Set character size (X, Y factor) 
MODE Y ## Colorswap X and Y 
MODE Z 
MODE [ XY XY Define source raster 
MODE \ F Overstrike on/off 
MODE ] CC# Operate on variable a 
MODE ~*~ # XY Area Fill (color, X, Y) 
MODE ~ Clear to end of line 
MODE a 
MODE b : 
MODE c # Set Background color 
MODE da 
MODE e 
MODE f 
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MODE g 

MODE h 

MODE 1 ### Load User Character Set 

MODE j 

MODE k 

MODE 1 Erase to end of screen 

MODE m ## Move Cursor relative 

MODE n 

MODE o 

MODE p 

MODE gq 

MODE r | 

MODE s XY XY Set Scale Factors 

MODE t C Test window 

MODE u XY Copy raster to X-Y with overstrike 
MODE v n Set Overlay future visibility 
MODE w | 

MODE x # Set vector width 

MODE y ## Set colors (X to Y) 

MODE z 

MODE { # Set Source Raster direction 
MODE | Home lower (lower left corner) 
MODE } 

MODE ~ # XY Edge Fill (color, X, Y) 

MODE DEL C Ignore argument (undefined keys) 
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Plot Codes 


Plot codes will accept repeated arguments. They may also 
require an initial set of arguments, as in the case of 
Incremental plot submodes. In this list, the repeated 
arguments are shown in braces {}, and initial arguments (if 
any) precede the braces. 


Plot codes always begin with the PLOT character. CTRL B, 
@2 hex. 


Arc: {X, Y, radius, start, delta,} 


Circle: {X,-Y, radius,} 
Dot: {X, Y,} 
Vector-drawn characters: angle, F, {char} 


Incremental Vector: X, Y, {dxXdY} 


Two-point Circle: {X, Y, Xl, Y1,} 
Polygon: {X, Y,} ;3 


Rectangle: {Xl, Yl, X2, Y2,} 


Triangle: {Xl, Yl, X2, Y2, X3, Y3,} 
Curves: {Xl1,Yl, X2,Y2, X3,Y3, X4.,Y4,} 
Vector: {Xl, Yl, X2, Y2,} 
Concatenated Vector: X, Y, {X, Y,} 
Incremental X-bar: X@,Y@, {X,} 
Incremental Y-bar: X@,Y@, {Y,} 


Ray: {X, Y, radius, angle, } 


tg 
Et 
O 
| 
IM ZFAONKKSEQCCHNWOVOSZSYVAGHTONMOUANW Se 


rg 
tt 
O 
hy 


as) 

ct 

O 

a 
Ae Tr hho aa oo m® 
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PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT 
PLOT DEL 


Bold Vector: {Xl, Yl, X2. Y2,} 
Bold Concat. Vector: X, Y, {X, Y,} 


Iw— KSNK KM EGCeErHnNRQVOssS 
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Escape Codes 


Escape codes always begin with the ESC character, CTRL [, 1B 
hex. | 


ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 


Align Pan to Cursor 
F Binary Mode (ESC and USER codes) 
+ # + # Change color (color, R, G, B) 
# Delay <#> retraces (or till keypress) 


Zoom up 
Zoom down 


XY Pan to X-Y 
XY..-XY¥; Polygon ( >39 points) 
# Plane Video Switch 


££ $F Tone (Hz, Hz, Hz, milliseconds) 


CF Visible control-chars in window on/off 


CG Absolute Zoom 


rm 
~ 
o' 
S++ YMmNH KMS AICACANnNWOVO BZ SBSYPROUHMADwDVOVAWPe 


tm 
ep) 
QD 

a 


# Blink Select © , 
t### «©. Change color (color, H, V, S) 


Pan left 


Pan down 
Pan up 
n Load default color table 


rm 
dp 
O 
MN~mM~oOD SB RMR IO hoandn ow 


F Overlay cursor blink on/off 
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ESC rx 


Pry. 


ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC DEL 


F = = 


Iw— HONK KE SG oC tM 
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Select image 


View sub-buffer 


Pan right 
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User codes always begin with the USER character, 


hex. 


USER 
USER 
USER 
USER 
USER 


A 


User Codes 


MK INK KX SKCHNWOVO SSE RAGHTOAAMONW Pe 


a 


a 
b 
Cc 
d 
e 
‘3 
g 
h 
i 
J 
k 
1 
m 
n 
O 
p 
q 
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Special Codes 


CTRL U, 15 


Execute Terminal Emulator 
Append to Create Buffer 


Create On 
DMA Access 


Full Duplex 


Half Duplex 

Assign Input Device 
Execute Function Key 
Kill Sub-Buffer 
Local Duplex 

Execute Monitor 


Assign Output 


Clock display on/off 

Redraw the Create Buffer 

Set Serial baud rate: port, baud 
Execute THAW routine 


Warm-start (re-enter program) 
Transmit the Create Buffer 


Literal Create On 
Enable Joystick 


Insert into Sub-Buffer 


Restricted Terminal Emulator 

Boot Idris (normal) 

Boot the system 

Create Off 

Execute Disk Operating System (DOS) 


Hardcopy 
Idris Boot Routine 
Define Function Key 


Boot DOS (no password entry) 
Set time clock 
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USER rv ###nnn; Modify SPC port 


USER s #CCC Set Serial stop bits, parity, word length 
USER t , : 

USER u 

USER v ## Change Case Table entry 
USER w ## Swap Case Table entry 
USER x CC Transmit window variable 
USER y CC. Display window variable 
USER Z ####¢#4# Set EOL sequence 

USER { 7 

USER | CCn Enable light pen 

USER } 

USER ~ 

USER DEL 
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Command Reference List 


This section is a brief guide to the operation of the 
CGC 7900. Commands are listed here by name. For details on 


any command, consult the detailed descriptions in the main 
body of this manual. 
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Function Code Sequence Key Page # 
eee Tes Sete pee eeene en prem enmnmmnmnen 

Are ' PLOT A XY #,#,#, | ARC H Q-4 
Sone mewn oe ee ee ee men pow ee eee mene emer epa eee meee eee fpe eae eee 
Area Fill } MODE * #, XY H AREA FILL H 8-28 
A ae ee en ee ee fo ee a ee es ee a es nn ae a ns em eee oc oe en ee ne 00 a a ne a a woe en we a ee an an eo en nee ee ee ee 
Assign Input Device { USER I nC | { ASSIGN INPUT | 3=4 
Ae en a poe e een een ew en en =e ee co on oe fae ao a mm eo ce no 
Assign Output Device ! USER O nCCCC { ASSIGN OUTPUT | 3-2 
eT eee epee enn n epee eee eee epee enee 
Background Color {| MODE c #, { SHIFT SET {| 2=10, 8=13 
eo en ee a a aera a ce on a ee me a ee eo afer Om wo ee ae a a en On oe en ee en ee a mf Oo a ms ee 
Boot | USER b BOOT 1-16 
Seem meee ene wn e em neen nee ee eS et ee 
Binary Mode: | 
_ ESC and USER | ESC BF ' ' 7-9 
MODE and PLOT | MODE B F | 7-8 
a ae a a ae ee ee ee eee me nme meee eee pe ee ee eee epee eee eee nnn enema = 
Blink ! MODE K F BLINK 2-10, 8-6 
So ts SD GAS MO a OE EE GE AE GD GED GED GED UD a EE GED SED SS OD GED ER MD ao a meen awe Gm co a mane om come an cea oa ae Ho Co EE of ene dew Ms EE ee RD Cann OED aE Gray ene Gg ce cn ace com em Co sh Sak SOTO RNS EGER WER GD in ey ar Sem ts 
Bold Vector | PLOT v XY XY 9=23 
ap ca am cm ce a ae > > an a ee ae ae a we oe a ow ms em me wpaw ae on as ee en ee ew ae em em ee aes om fee a on ee oe cms eer ope me om ae we en rs cer ce on mom oe 
Case Table: | 
Change entry | USER v #,#, 4~20 
Swap entries | USER w #,#, H | 4~20 
See eee ce a at aie 
aracter Set: 8-10 
fault | MODE i 6,8.0, 
‘efined | MODE i #,#,addr, | 
ooo fo ce ene men mw wmmmeme ope ee ee ee $e ewww eam we 
Character Size {| MODE X #,#, SIZE 8=8 
Pe a ee ew ee fe a oe cn 0 ee ee nn en ne cn fee on oe en on em ee en an sn et nfo ws ws we ae a ae eee ee ee 
Circle: ! ! 
Normal { PLOT C XY #, | CIRCLE 9=-5 
Two=Point {| PLOT O XY XY 9-6 
See meee meme ee me me ee ec cm ce a oa mene tae ee ene ce ace Oo ee Ot SPS On Rw em oe ene 
Colorset | MODE y #,#, {SHIFT COLORSWAP} 8-22 
oo omen an an an 0 On a Se ae ae Oe Oe Oe cae ae ae am en ne ee ae Oe On eae ne nn focae Ge Man 9D Om OO oe a One Os Om On a om Oe ea eee Ow a an OD OD On On 0 om on Oe a Oe ce fe oe Oo ene ee en OO On oD ae eo 
Color swap | MODE Y #,#, H COLORSW AP 8-22 
Se et to om oe foe mma Oe mee me eee 
Color Lookup Table: ' ‘ 
Change Entry (HVS) | ESC c #,#,#,#, {| SHIFT CHANGE |} 8=20 
Change Entry (RGB) | ESC C #,#,#,#, ! CHANGE ! 8=17 
Default ! ESC 1 #, 8=21 
eb re SA SH ee sn Sealant ee ea Set a 
Communi cations: 
Full Duplex { USER F Yad 
Half Duplex ! USER H yo If 
Host EOL Sequence | USER z #,#,#,#, #, #, #, #, Yun 17 
Local { USER L : Ya 3 
Serial Baud Rate | USER S #,#, (port,baud,) | Yo12 
Serial Parity, | USER s #,C CC yo] y 
Word Length, : ! 
Stop Bits H ! 
Se ee eee mee een ewe ne Seale aaa a 
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Function 


Create Buffer: 


Append 

Define Sub-Buffer 
Insert in Sub-Buffer 
Kill Sub-Buffer 
Literal Create 
Redraw 

Transmit 

View Sub-Buffer 


Normal 


Editing Commands: 
Clear to End of Line 
Clear Line 
Delete Character 
Delete Line 
Erase to End of Screen 
Erase Page 
Insert Character 
Insert Line 


Function Keys: 
Define 
Execute 


Hardcopy 
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Command List 


Code Sequence Key Page # 
of ee eee ee eee eee reheated peat teal See tentemton ee patent Tneeeetenteeteelotenteataa! 
Y PLOT wo XY ees. I g~24 
of een ene ene oe ne S see lenteebententaetentetentontententetoe fo ee meee ee eee 
' PLOT W XY XY ... | CONCAT VECTOR |} 9-22 
oon of ae om Om Oe Om om oe oe oe eo oe oe oe ee foes eee eee ewe e = peo ece wee 2 ee eee ee 
! USER C (ON) ! CREATE ! 5-2 
' USER c (OFF) ' SHIFT CREATE |! 5=2 
! USER A | | 5-3 
! CTRL X 5-5 
' USER * #, 5=6 
| USER K #, 5-7 
| USER [ 5-9 
! USER R | 5-4 
| USER X 5-4 
| ESC v #, | SHIFT VIEW | 5-8 
ae ee ee ee spe ee ae ae a em er a oe on ee fee em ene eee ee eee 
! MODE Q #, | 8~25 
pee ewe ne nn eee meee poem nn en nee $e eee ee eee eee 
! MODE J F ! CURSOR ON ! 2-5 
$e eee mm en ner eee fo ee eee meee Slee aetaesteelael ee leteteetenten teen teatentaatens 
' PLOT U XY XY XY xy! CURVE ! 9=7 
ope ene meme mmm meee Scanlan tantn eaten oalentototetenteen » easton taenlaon on omtoe omelette ten toe tons 
| ESC D #, | Seals 
ope em en ee ewe meee ee $e eee eee eee weee S seleaetentaeteatnteelpeleetantestneten toate 
' USER D addr,#,n | | 4~18 
ofp ee ee eee eee eee Spm ae meen ee ee $a we em ne meme ne eee 
1-6 
' USER d DOS 
! USER p | SHIFT DOS } 
ope eee emer e eee eee $e ee em ew eee ene $e eee ewe neem eee 
| PLOT D XY | DOT 9~9 
fee ee wee ewe eee eee fo eneeme new e ee == peewee nner m em nee e eee 
| MODE ~ #, XY ‘SHIFT AREA FILL} 8-29 
epee mee nen m nn eee foe wee ene w eee Scarlett elena eaten 
| | 
' MODE * ! CLEAR EOL | 2=5 
' MODE @ ! CLEAR LINE | 2~4 
! MODE < 1 DEL CHAR ! 2—5 
! MODE < 2 DEL LINE |! 2=5 
! MODE 1 | ERASE EOS $$! 2=5 
! CTRL L | ERASE PAGE } 2—4 
' MODE > 1 ! INS CHAR ! 2—5 
! MODE > 2 ! INS LINE |! 2=5 
poe meen nnn nee eee Seether eeeeereteteatans poem rem ewe eee ee ewe 
|! MODE F F FILL 8~26 
tt os re se a ae a ee ee ee 
! MODE C #, ! SET ! 2-9, 8-12 
few nw ween wenn ree peewee meee meme fo ee meee mem eee eee 
| 3-8 
' USER j ! DEFINE ! 
| USER J C 
of eee eee meee een selene eee eee $e ee ee een nn nn ee eee 
' USER h | SHIFT COPY ! 3=34 
of meee ne eee memes see oe we ae oe en ee ee ae ee oe a $e ee ee ee eee eee mene 
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Function Code Sequence Key Page # 
eee meee emma rs ee ee eet H pee mene wn ee 

Idris: | | 1-6 

Normal { USER a IDRIS H 

Special Monitor | USER i | SHIFT IDRIS | 
Se Re RE Re See ee mee foe meme po ance ewe e 
Incremental Vector | PLOT I XY #,#,... | INC VECTOR | 9-10 
See en neem ee eee ra ee foe we wenn neem ewe 
Incremental X-=Bar 1 PLOT X XY #,...#, | INC X-BAR 9-13 
On er a cae a OP GD OE OD OD OP SD OD SD OD OD OD GD ED nD OD OED OD CD ae peo am om on wn an on om on a ae a On ae om am a om eevee a om On om Om oe oon an ee we cae Oe eon ee On oe en eo oe a Do 
Incremental Y-Bar | PLOT Y XY #,...#, | INC Y-BAR 9-15 
oo oe a ae ee mae On ae a Oe en On ee nee ne ee a » vertueteeeetaett estan latest Tee tetoetentaats ooo tea teat ttt te Dt T ot Dr a Se a Se 
Intercharacter Spacing ' MODE I #,#, 8=9 
0 ee en as a oe ee ee fem mw nomen meee meen epee meen m emo w enna meee ene ene meee e ne 
Joystick {| USER \ F 8=30 
0 cree oc wo ett ae oc a ee ae ar no an wn a ws a we Setanta eaten eet poem enn nwe 
Keyboard Syne { MODE ? ! Ym 16 
ae co am ae ae ee a en an an a os ew on en re am ere cfm we en ce ee we ee nn a ae a we ee foee  e oe on e n ee cfoces ee oe a a oe ee 
Light Pen |! USER | CCn 3-13 
<= Gas aoe ean aan an an Om OD On a DO ee ee a a ee eee oe a ae an aw we an an a ae cn en a a ae ofan on ae an ae an oe on om aoe en ow om en oe epee ae ae om ae an an an om een ee ee ee aw ae eee ome 
Monitor | USER M MONITOR 1-6, C=1 
Se foe a meme n mn ee poem meena eee meme ween 
Move Cursor: | | 

Absolute | MODE M XY MOVE X-Y 2-5, 8-24 

Relative ! MODE m XY | 2-6. 8-24 

Cursor Up { CTRL K up-arrow 2=4 

Cursor Down | CTRL J | down=arrow | 2-4 

Cursor Left | CTRL H |  leftearrow | Q—4 

Cursor Right { CTRL J | right-arrow | 2—4 

Dot Up | CTRL E 8=23 

vot Down | CTRL V 8=23 

Dot Left { CTRL Y 8=23 

Dot Right | CTRL _ 8=23 

Home {| CTRL \ HOME 2—4 

Home Lower {| MODE } CTRL HOME ! 2—4 

Tab {| CTRL I on 
en ee a oe oa a to Do foe ee ce ee a cn a ee ee a eee ee ee epee ee ee ee 
Overlay: | MODE O F | OVERLAY |! 263, 8-3 

Cursor Blink | ESC q F 2=6 

Visible Attributes | MODE V n (present) } 2=11 

{ MODE v n (future) } | 2-11 

0 at a Ce ND END SE RD RM SNE OED GD OD SD ER res ae om on am am on om an on oe a ee iste ae en dies SP Oe SS ONE NE ME SO CaS SD NE com peas an on an an ae on an an on om On om we on om on oe 
Overstrike | MODE \ F ! 8=11 
Se ee ee eee eee eee pee eee ewe meee ee ene pe ee wee me eww nnn pow e mee we wee wenn ene 
Pan: 

Absolute | ESC M XY ! PAN X=-Y 8=33 

Pan Left }-ESC h | M2 left-arrow | 8=31 

Pan Right | ESC } | M2 right-arrow!} §=31 

Pan Up | ESC k {| M2 up-arrow 8=31 

Pan Down ! ESC j | M2 down=arrow | 8=31 

Reset Pan | ESC M 0,0, | M2 HOME 8=31 

Align Pan to Cursor | ESC A ! M2 CLEAR LINE } 8=32 
se co oe oe a em mn 0 ee ae a ae ee an ee am eae ee me a ee en a 8 en a ee en om en fee On a ee ee a ea a en aw ee afree ae 


Page A~-14 


Version 1.4 


Appendix A 


Function 


Polygon: 


Large ( >30 points ) 


Normal 


Raster Processor: 
Define Source Raster 


Copy Raster 


Copy with Overstrike 
Set Raster Direction 


Recall: 
Forward 
Backward 


Real-Time Clock: 
Display Time 
Set Time 


select Character Set: 


Alternate 
Standard 
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Command List 


Code Sequence Key Page # 
S ceentaertnetanetontantetenleeanestentaatee ten ten eaten foe meme eee eee fo cee eee mee 
MODE T nn 10~8 
ao an on oe on an on on on on aw an an an oS en en en ee cf ee ce es eo eee ec we we we oe we oe ee oe oe oe ee oe oe oe se ee 
MODE : #, 11-4 
eae O00 ew Oe ey a ES I EE SP cD oD aD MD cw in cls GE deme afres am on as ow ae an an am om om om om oe en af em OD aan Om Om am on Gm om om On Oe OD Oe Oe oe oe oe 
ESC S #, 11=5 
om OD Se OS Ga One ON aD OD OD Oe Oe Oe OD Oo oe OD Oe epee om on am om an an on on am om oe on Os aah oe On an Om Ee on oe On Om OD On On On one Om we om oe 
MODE P F ! PLOT 9-28 
an Oo on an as an em a ea eee epee os oe om ae om om a on on om 0 oe on af Om oe os ee ee Oe ee oe 
ESC P XY¥...XY;3_ { 9-17 
PLOT P XY...XY; ! POL YGON 9~16 
Se GD a yO nS GS EE SG OD oe fees eam ne am eae an eae an Os oe om oe oe On om afee One O m Oae Om Oo Oe Ome OD em OD a OS es Om Oe 
MODE [ XY XY 10-2 
MODE U XY ! COPY | 10+3 
MODE u XY 10—4 
MODE { #, | 10=5 
an G0 One Sa aa am Se aD Ga GS MD GD Gam Ge SD oD en af em om om oe om on om on oe oe om wn om oe en ef ee Om on Om On om On On On Oe Oe ae Oe me Oe oe os 
PLOT \ XY #,#, RAY | 9-18 
oe SD OES SD GE NS GD Gan GD SE ED OE GED Ow aD aD aD Go ao ofp ee ane om oe oe om om en oe oe oe on ne on oe of Om ae Om Oe Oe Oe Oe oe oD oe ee oe Oe 
MODE DEL 1 RECALL C=3 
MODE DEL 2 ! SHIFT RECALL |! Co3 
oe OF Ca OP Ge SD A A GE GD GD GD GED a CD ce ED ea ee fee om om om on om oe om on on om we on on om ofa Om ae On om on am on on on em ae om On om om om ee 
RESET 1=<17 
CTRL SHIFT RESET 
CTRL SHIFT M1 M2 RESET 
ee Om aan a ae On Oe Oe SO ow ae OD Oa ee Oe Oa Oo Ot ee ofp om ae on os om on om om om om coe oe oe on fee Oe we oe Om oe oe Oe On oe ee om 
USER Q F | 3-16 
USER q nnnnnnnnn; | 3-15 
on Oe Os Om On on Gn On Oe On ow ae an Oe On a oe om oe feces as ae oe ae eae om oe oe om oe re ae oe foe Ow oe Oe oe Oe On on Oe es Ge Oe 
PLOT R XY XY RECT | 9-19 
nO Oe Oe Ot Oe aD OD OD OD OD ED ED OD OD OD eD Om pe oe ee oe on oe on oe oe om ee ee om of ee oe en oe Oe Oe Oe ee oe eo 
MODE R F | ROLL 2-7, 8-36 
oo am oe a nom om om oe me a oe Oe ee os pee oe ce ce ae oe oe ae we ee ee en oe fee ee ee Oe Os ee eee ee we eee 
MODE E F ! RUBBER BAND | 8-37 
om Oe OS GD a GO ED GO ED OD oe ee Oe ee ao aE are afr cae cae coe ene cae cae ce ee cae ean as ae a am wfc ee Ot Go ae Oa a Gan Go Ge Ge Gm Go en Go Oo co eo: Sm 
MODE S F 3-31 
20 Gn Oe OD Oe ae Gee EO On OD Om ON GD Oe Om ee eae ae ofp cae ee rn cae em ae mee com en em Om ae en oe mf ee com Gm OY GE OD ME OED ce Cm Mem RED Om me ED ec Oe 
MODE s #,#,#,#, ! SCALE 3-27 
A es Me GD Se GD GD cee Sa Se nD SD ce Meme Gam GD a freee oe a oe oe om om on om on oe an oe on en foe 08 one Oe oe ne oe oe oe oe on on Oe oe oe oe oe 
USER r #,#,#,nnn; | 4-16 
aan SD SP A es aD Se KD nD Gem GD Ma GD Se eS Ge ame ome ee ae eee em ee oe oe cae oe om oe ee ee ee ee of Om oe Oe oe oe Oe Oe Oe ee 
MODE = ' SOFT BOOT ! 1-17 
2 Oe Om an ae ae Se an Oe eae Om Oe Oe Om Oe oe oD Oe oe ofan oe ce an ae ae Se as SO ee Re ee Ses Ms cafe ome GE GO EE OE Sew eae Hn UD ny cm ew EeD Ges GD Si 
ESC b #, 8-7 
mae ee OP on ae Oe oe Om oe oe ee Oe Oe oe oe OD foe oe ae oe eee aoe a oe oe an ne ee no a fe 0 oe oe oe Oe om Oe On om oe we ee oo 
CTRL N | 3-6 
CTRL O 3-6 
an On Gn OS On on on on an ae an on em an am an eee om af ae ast ie ae ar a ae Om ey cee a ce Oe Se cae af ee ND SS SE MEP May MED Shay GD ins ER SoD SD GORD ate 


+ ~~-— -- 
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Command List 


Function 


Gan Gi) Ge Gap Gun Gy Gap aus Gap GE aN Gm Cas Ble Gm Gum GT Gay Gay GS Ge HS Us Gam CE Ge EH Cae 


Select Image 


Vector Width 


Visible Control Characters 


Window Variables: 
Display 
Operate 
Transmit 

Zoom: 

Absolute 
Zoom Down 
Zoom Up 
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Code Sequence Key 
fp em eee shaw or ree re mes a mt 
| ESC s F 
ofan ae oe a a a a a en ee oe ee ee fee en ee ae ee a a aes ae a a ae 
| USER @ | TERMINAL 
| USER * 

S eeteaetebed Oe en oe ee eee eee fo eee eee eee eee 
| MODE t C TEST 

ofp ae mee we ee ee fo ee eee eee 
{ USER T THAW 

fa en a ae coo ae ce ne com nm me Sa ceecnlapelaeetaeteet enol nel on anloeettaeions 
| ESCT #,#,#,#, | TONE 

+ sentuataetentienlanetentententteetentetaetonteetantontes ha ee ee ee 
| PLOT T XY XY XY | #£TRIANGLE 

fore eeme ee eee eee she a ee 
' PLOT V xy xy ! VECTOR 

pee eee eee eee em wee $e ee eee eee eee 
{ PLOT E #, F chars } 

fee Cem eee meee fea ae ae en ee a en es en ee en ene ee 
| MODE x #, {| $V. WIDTH 

ape ae ot ee em om cs a a ae a ee a oe oe no span ae an oe ee an ee ee ee 
' ESC VCF 

fee eee eee eee ewe ewe fee ee ee eee meee 
' USER W 

fee ae oe ae oe ae on ae oe a so oe ne oe afar ae ee eee 
| MODE W XY XY WINDOW 

Steet ent ee eed eelo alee aateata pe eee we ee 
' USER y CC | 

' MODE ] CC #, 

| USER x CC 

fee emer wee eee oe eee ee eee eee mene 
| 

' BSC ZCC | 

| BSC K | M2 RECALL 

' ESC J ! M2 ERASE PAGE 
few eee meee eee ene ae a ee ee ee ce cr ae ee a 


eee 


Sie Se CN ee ee nee 


en eee eee 


tne ee ee ee re eee 
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Key Sequences 


All the keys in the top four rows of the 79990 keyboard 
generate multiple codes when struck (except RESET and CALC 
MODE). The keys on the cursor keypad (between the 
alphanumeric keyboard and the numeric keypad) also generate 
one or more codes when struck. The following list shows 
which keystrokes produce sequences of characters. Function 
key sequences are also described on page 3-12. 


Keystroke sequence 
ARC PLOT A 
AREA FILL MODE ~* 
ASSIGN INPUT USER I 
ASSIGN OUTPUT USER O 
BLINK MODE K 1 
BOOT USER b 
CHANGE ESC C 
CIRCLE PLOT C 
COLORSW AP MODE Y 
CONCAT VECTOR PLOT W 
COPY MODE U 
CREATE USER C 
CURSOR ON MODE J 1 
CURVE PLOT U 
DEFINE USER j 
DOS USER d 
DOT PLOT D 
FILL MODE F l 
IDRIS USER a 
INC VECTOR PLOT I 
INC X-BAR PLOT X 
INC Y-BAR PLOT Y 
MONITOR USER M 
MOVE X-Y MODE M 
OVERLAY MODE O 1 MODE V 3 
PAN X-Y ESC M 
PLOT MODE P Il 
POLYGON PLOT P 
RAY PLOT \ 
RECT PLOT R 
ROLL MODE R l 
RUBBER BAND MODE E 1 
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Keystroke 


SCALE 
SET 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SIZE 


AREA FILL 
BLINK 
CHANG E 
COLORSW AP 
COPY 
CREATE 
CURSOR ON 


SOFT BOOT 
TERMINAL 


TONE 


TRIANGLE 
V. WIDTH 
VECTOR 


VIEW 


WINDOW 
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Cursor Keypad codes 


down-arrow 
left-arrow 
right-arrow 
up-~arrow 


SHIFT 
SHIFT 
SHIFT 
SHIFT 


CLEAR 
CLEAR 


up-arrow 


EOL 
LINE 


CTRL HOME 
DEL CHAR 

DEL LINE 
ERASE EOS 
ERASE PAGE 
HOME 

INS CHAR 

INS LINE 
RECALL 

SHIFT RECALL 


CLEAR LINE 
ERASE PAGE 
HOME 

RECALL 
down-arrow 
left-arrow 
right-arrow 
up-arrow 


Function Key codes 


Fl USER J A 

F2 USER JB. 
F3 USER J C 

F4 USER J D 

F5 USER J E 

F6 USER JF 

F7 USER JG 

F8 USER JH 

F9 USER J I 
F1@ USER J J 
F1ll USER J K 
Fil2 USER J L 
Bezel 1 USER J 
Bezel 2 USER J 
Bezel 3 USER J 
Bezel 4 USER J 
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CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 


Kno 


CTRL 


CTRL 


MOD 
MOD 
MOD 
MOD 
MOD 
MOD 


CTRL 
CTRL 


MOD 
MOD 
MOD 
MOD 


ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 
ESC 


ER 
E 
E 
E 
E 
E 


E 
E 
E 
E 


DOOVVS OKA A—@D 


4) 


Aw WS GP 


F13 
F13 
F13 
F13 
F13 
a 
F13 
F13 
F13 
F13 
F13 
F13 


Noe 


De 


USER 
USER 
USER 
USER 
USER 
USER 
USER 
USER 
USER 
USER 
USER 
USER 


Bezel 5 


Beze 
Beze 


1 6 
Lh 


Bezel 8 


Key Sequences 


CEQ agg aangnarg 
SSQCCHNnNDOVO AS 


USER J [ 
USER J \ 
USER J Y 
USER J Z 
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Color Key codes 


BLACK 0, SHIFT BLACK 8, 

BLUE 1, SHIFT BLUE 9, 

GREEN 2. SHIFT GREEN 10, 
CYAN 3, SHIFT CYAN li, 
RED 4, SHIFT RED 12. 
MAGENTA 5, SHIFT MAGENTA 13, 
YELLOW 6, SHIFT YELLOW 14, 
WHITE Ty SHIFT WHITE 15, 
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Inline Editor Commands 


To date, the Inline Editor is used in the following 
Chromatics software: 


e DOS (including Editor) 
e CGC 7998 Monitor 


e Idris Editor "ne" 


Command Key Sequence 


| 
am que nae ne came ee eee GED Gam One GEE MED GED Gm Gee Ome Ee Gee ee ED ne ane cow ere Ome Coe me ame Oo Oe os One + 
Clear Line | 
Clear to Beginning of Line | 
Clear to End of Line | CTRL CLEAR EOL 
Delete Character | CTRL DEL CHAR 
Delete Word | CTRL SHIFT ERASE PAGE 
| 
| 
| 
| 
| 
| 
+ 


CLEAR LINE 
CTRL SHIFT CLEAR LINE 


Insert Characters CTRL INS CHAR 

Literal Mode CTRL G 

Move Cursor <left arrow> <right arrow> 
Move to Beginning of Line HOME 

Recall Back SHIFT RECALL 

Recall Forward RECALL 
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Appendix B -- Color Display Schemes 


The human eye is a remarkable instrument for distinguishing 
color. It can adjust to an enormous variety of lighting 
conditions and intensities, and interpret extremely subtle shades 
of color. No present method of generating a color graphics 
display can produce the entire range, or "gamut," of colors the 
eye is able to interpret. All present methods must employ some 
sort of model, representing a certain subset of the eye's color 
gamut. 


The way in which most color graphics systems (including the 
CGC 7998) produce color is to provide three color "guns" in a 
Cathode-Ray Tube, or CRT. The three guns each produce a primary 
color. One gun is asSigned to red, one to green, and one to 
blue. If the intensities of each gun can be independently 
varied, a good color gamut can be represented. 


The 7990 allows each gun to vary from "full off" to "full 
on" in 256 discrete steps. Studies have shown that this 8-bit 
resolution in the intensity scale is necessary to produce tne 


appearance of continuous shading. A change in intensity of one 
part in 256 is not detectable by the eye. 
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The Color Cube 


Since we use three guns in this system, one for each of 
three primary colors, we can represent this system by a set 
of three-dimensional axes. Assume the X-axis represents red, 
Y represents green, and Z represents blue. If we allow the 
intensity of each gun to vary between zero (completely dark) 
to 255 (maximum brightness), then we must label each axis 
with numbers from 9 to 255. (The limit 255 is,- for now, an 
arbitrary limit. We could just as well have defined limits 
to be from zero to one, or any other pair of numbers.) 


The origin of this three-dimensional space is at the 
point 9, @, @, which is black (no intensity in any gun). The 
point of maximum intensity in all three guns is labelled 255, 
255, 255, and is white. A point along any of the three axes 
will represent a color with only one component: for example, 
any point along the "red" axis will have a component of red, 
but no green or blue. Greys have equal intensity of all 
three guns, so all grey levels fall along a diagonal line 
between 9, @, @ and 255, 255, 255. 


We reStrict each axis of this system to numbers between 
® and 255. In doing so, we define a "box" or "“cube"-shaped 
area. Any possible color in the gamut of our CRT system may 
be represented by some point within this cube. Any points 
outside the cube represent colors which might exist in the 
eye's color gamut, but cannot be represented on the CRT. 


What we have just described is known as the Color Cube 
model, or RGB model. A set of three-dimensional axes may be 
used to represent R; G, and B, and any color displayable on 
the CRT may be described as a point in the space defined by 
these axes. The upper limit of intensity must be defined, of 
course; in the 79898, the upper limit is 255 units of 
intensity along each axis. 


The RGB model is useful. It accurately describes the 
gamut of colors we have available on the 7989 (or any other 
CRT device). Its drawback is that it is not easily related 
to the colors we see in the real world. 
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The HVS Hexcone 


A second model has been developed that accurately 
describes the CRT color gamut. The Hexcone is defined in 
units which are more appealing for humans to work with: 4Hue, 
Value and Saturation. 


Hue is the quality we most often refer to when we talk 
about "color." Hue defines the dominant wavelength of a 
color: red, blue, green, or some combination. A spectrum 
seen emerging from a prism displays a stream of colors, 
changing in Hue only. 


Value is the quality we refer to as "brightness" or 
"energy" in a color. When Value approaches zero, the color 
becomes black and Hue no longer has meaning. As Value 
increases, the subjective brightness of the color increases. 
A decrease in Value may be thought of as an increase in the 
amount of "black" in a color. 


Saturation is the quality that distinguishes a weak, or 
pastel color, from a strong, vibrant one. (For example. pink 
is the name we give a color whose main component is red, but 
which has low Saturation.) If Saturation approaches zero, the 
color becomes grey. (How bright a grey? Holding Saturation 
at zero, if Value changes from zero to maximum, the color 
changes from black to white.) When Saturation is zero, Hue 
has no meaning. Saturation is alwayS maximum at the primary 
colors, red, green, and blue. 


The Hexcone model shows many of the features we have 
described above. Every point on the Hexcone, or inside it, 
can be found in the gamut of a color CRT. Thus, the Hexcone 
is simply an alternate mapping of the same information 
contained in the Color Cube. And, in fact, there are 
mathematical functions which can translate RGB coordinates to 
HVS and vice versa. 


The top. of the Hexcone has six corners: the three 
primary colors, red, green, and blue, and the three secondary 
colors formed by adding pairs of primaries: magenta, yellow, 
and cyan. White is located at the top of the center plane. 
Black is at the bottom vertex of the Hexcone. It follows 
that all shades of grey lie on the vertical axis which passes 
through the center of the Hexcone. 


Hue is seen to be an angle; it is always measured by 
drawing a vector from the center axis of the Hexcone. Hue 
equals zero when this vector points to the red vertex, 
increases toward green, and increases still more toward blue. 
Hue reaches itS maximum when it returns to its starting 
point, red. | 
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Value is vertical height on the Hexcone. Value is zero 
at the black vertex, and reaches its maximum at any point on 
the top plane of the Hexcone. 


Saturation is measured by drawing a vector from the 
center axis of the Hexcone, through the point at which 
Saturation is to measured, to the edge of the Hexcone. (Note 
that the total length of this vector will vary. depending on 
the cross-sectional width of the Hexcone at the point of 
interest.) The total length of this vector always represents 
a Saturation of 190%, regardless of its actual length; and 
the Saturation at any point P along the vector is defined to 
be the distance from P to the center axis, divided by the 
total length of the vector to the Hexcone edge. Saturation 
is thus a relative measure, which interacts with Hue and 
Value. | 


Until now, we have carefully avoided using any absolute 
units for Hue, Value and Saturation. Units of measure for 
color have not been fully standardized; some systems define 
all RGB and HVS units to fall between zero and one. In the 
CGC 7900 we prefer to manipulate only integer numbers, so we 
use a range of zero to 255 for all numbers in the Hue, Value, 
Saturation system. 


Using this range (@ to 255), here are some examples of 
colors defined in both RGB and HVS units: 


Color — R | G B H V S 
Red 255 ) i) 4) 255 255 
Green - 4) 255 4) 85 255 255 
Blue g 4) 235 171 255 255 
Yellow 255 255 4) 43 Zo5 255 
Cyan Qg 255 255 128 255 299 
Magenta 255 ) 255 Pa a a 255 255 
White 255 255 255 * 255 ) 
50% grey 128 128 128 * 128 4) 
Black 4) Gg 4) sd G = 


* = undefined 


‘Red 255 g 5 °° °&g 255 255 


Pink 255 128 128 Q 255 128 
Light Orange 255 198 128 21 255 128 
Brown 144 95 64 21 128 128 
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Changing from red to pink. requires a change in both the 
green and blue components, but only changes Saturation in the 
HVS system. Similarly. the change from light orange to brown 
involves altering all three of the three RGB components, but 
only changes one of the HVS components (Value). These types 
of color changes would be relatively difficult to calculate 
if we were forced to use RGB, but they are easy to comprehend 
in HVS. 


Despite the lengthy definitions above, HVS units are 
generally very well-behaved and easy for an operator to work 
with. The CGC 7998@ allows the user to vary a color by 
adjusting Hue, Value and Saturation. Users quickly become 
accustomed to uSing this method of color selection, much as 
they would mix paints by eye: select a Hue by mixing primary 
colors, then add white (reduce Saturation) to lighten or mute 
the color, or add black (reduce Value) to darken it. 


Version 1.4 Page B-5 


Color Display 7988 Operator's Manual - Appendix B 


The Color Cube 


Blue Magenta 
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The HVS Hexcone 


Saturation ye I 
Se 


Se Se 
| 


Srey line Value 
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Appendix C ~-- The Monitor 


The Monitor is a program which provides primitive facilities 
for manipulating memory, registers, and input/output devices 


within the 790@. Its main use is debugging machine language 
programs. 


It is not necessary to understand this section before 
learning to use the rest of the CGC 7989 system. 


The Monitor is not designed to be used by beginners! 
Properly used, it can be a great aid for programmers working in 
68090 code, whether they are experienced with this particular 
processor or not. But the user who is totally unfamiliar with 
assembly level programming may find the Monitor quite baffling. 


This section describes the utilities available in the 
Monitor. To enter the Monitor, press the labelled key: 


MONITOR 
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Monitor Operations 


Some general comments are presented here concerning the 
commands accepted by the Monitor. 


Most commands consist of one or two characters, followed 
by the arguments to the command. Each command is terminated 
by the carriage return character (RETURN). The arguments to 
the command are separated by delimiters. 


The characters space, comma, and colon are all 
recognized as delimiters. They may be used interchangeably 
in the commands except where noted. In the format for each 
command we will use the comma for convenience. 


When the Monitor is displaying information, such as a 
list of the contents of memory, the display may be stopped by 
entering CTRL S (hold down the CTRL modifier and type an S). 
Pressing another key will continue the display. The display 
may be interrupted at any time with the DELETE key, which 
will return you immediately to the Monitor prompt. 
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The Inline Editor 


When entering a command line to the Monitor, the text 
editing functions labelled on the cursor keypad may be used 
to edit an input line. These functions include Insert and 
Delete Character, Cursor Left and Right, Clear Line, Clear 
EOL, and Recall Last Line. (The functions labelled in blue 
are accessed by holding the CTRL modifier while pressing the 
indicated key.) 


The left and right arrows move the cursor around on the 
input line. The HOME key moves the cursor to the first 
character of the input line. 


CLEAR LINE deletes the entire input line. CLEAR EOL 
(Clear to End Of Line) deletes all characters from the cursor 
position to the end of the input line. DEL CHAR (Delete 
Character) deletes one character at the current cursor 
position. 


INS CHAR (Insert Character) begins the Insert Character 
input mode. After entering Insert Character, the character 
under the cursor begins flashing. Any characters typed in 
this mode will be inserted into the input line at the current 
cursor position. To leave this mode, use the left or right 
arrow key to move the cursor. Now, any characters entered 
will overwrite the character underneath the cursor. (This is 
the default input mode.) 


CTRL SHIFT CLEAR LINE deletes all characters from the 
cursor to the beginning of the line. CTRL SHIFT ERASE PAGE 
deletes a word from the input line. These two functions are 
not labelled on the cursor Keys. 


The Recall function brings back a copy of a line 
previously entered. This is useful for repeating a command 
several times, without having to retype the entire command. 
Press RECALL to bring back a copy of the last line entered. 
Press the key several times to bring back earlier lines, 
moving backward in the Recall buffer. If you go too far 
back, press SHIFT RECALL to move forward in the buffer. The 
number of lines in the buffer is limited by the size of the 
buffer and the length of the lines. 


When the RETURN key is pressed, the entire visible input 
line is entered aS a command to the Monitor, regardless of 
the current cursor position within that line. This means 
that it is not sufficient to "backspace" over characters to 
delete them: the unwanted characters must be physically 
deleted from the line with the Delete Character, Clear Line, 
or Clear EOL functions. 


If you need to execute special code sequences while in 


the Monitor, simply enter the desired sequence. Escape and 
User code sequences will be immediately executed. Mode and 
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Plot codes will be displayed on the input line (using special 
characters), and will be executed when the RETURN key is 
pressed. This allows you to enter a Mode code sequence, edit 
it using Inline. then execute it. Similarly, if you wish to 
execute an Erase Page or other special control function, type 
it in and it will appear using special characters. It may be 
edited in the standard manner, and when RETURN is pressed, it 
will be executed. 


Pressing CTRL G (the "bell" code) causes Inline to enter 
Literal mode. In Literal mode, ALL control-characters may be 
entered into the Inline editor, including the carriage return 
code. Thus, once Literal mode is in effect, you are unable 
to press RETURN and have the system execute your input line. 
Literal mode is designed for text editors and other advanced 
programs, and it is not normally used in the Monitor. If you 
do enter Literal mode, typing a second CTRL G will exit this 
mode. 
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Monitor Commands 


Abort 


If a machine language program is executed uSing the 
Monitor, it may be aborted at any time by pressing any Bezel 


Key. All registers are displayed, and control returns to the 
Monitor. : 


NOTE: 


After entering the Monitor, the Bezel Keys will 
ONLY perform this Abort function. Re-entering the 
Terminal Emulator and trying to define a Bezel Key 
will result in aborting the Terminal Emulator 
program! If the Bezel Keys are to be used as 


user-defined keys after leaving the Monitor, the 
system must be Booted. 
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Change Memory 
Formats: 
CB <addr> RETURN 
CW <addr> RETURN 
CL <addr> RETURN 
The Change command allows — to modify memory, starting at 
address <addr>. You may modify bytes, words, or long words, 
uSing the CB, CW or CL form of the command. 
Change displays an address, and the contents of memory 


at that address, then asks for input. You have four options: 


6 Enter a hex number and press RETURN. to enter 


a value into that address and examine the next 
address. 


@ Press RETURN, to skip that address without 
- modification. 


e Enter a carat (*) and press RETURN, to examine 
the previous address. 


® Press DELETE, to terminate the Change command 
and return to the Monitor prompt. 
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Checksum Memory 


Formats: 


+ <addrl>, <addr2> RETURN 
Where: 


<addrl> and <addr2> are hex numbers delimiting the 
memory range to be summed. 


The memory locations between <addrl> and <addr2>, 
are summed, and the result displayed. The sum is a 
Sixteen-bit number, obtained by summing either all of the 
EVEN bytes, or all of the ODD bytes, in the memory range 


specified. If <addrl> is even, the even bytes are summed. 
If not, the odd bytes are summed. 


inclusive, 


Example: 


+4900,5FFE RETURN Sum all EVEN bytes 40090 - 5FFE 
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Compare Memory 
Format: 
K <addrl>, <addr2>, <addr3> RETURN 


Where: 


<addrl>, <addr2>, <addr3> are hex numbers 
Specifying the memory ranges to be compared. 


The contents of memory between locations <addrl> and 
<addr2>, inclusive, are compared to consecutive locations 
beginning at <addr3>. Any locations which do not match are 
displayed. During this display, you may press CTRL S to 
pause, or DELETE to stop. 


Examples: 
K4000,4FFF,5000 RETURN 


The contents of memory locations 4990 through 4FFF (hex) are 
compared to locations 5@8@ through 5FFF. 
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Disk Read 
Format: 
R <disk#>, <block>, <#blks> <addr> RETURN 
Where: 
<disk#> is the disk you want to read from. Values of 9 
and 1 refer to the left and right floppy 
drives, respectively. Values of 2 and 3 refer 


to the internal and remote hard disks. 


<block> is the first block to read from. Legal values 
depend on particulars of each disk. 


<#blks> is the number of blocks to read. Each block is 
256 bytes long, except blocks on track @ of the 
floppy disks. These blocks are only 128 bytes 
long. 


<addr> is the starting address of the block of memory 
receiving the disk data. 


The contents of the specified disk blocks are read into 
memory starting at <addr>. 


Example: 

RO ,108,2,18000 RETURN 
Blocks 1898 and 101 of the left-hand floppy disk are read 
into memory starting at location $190060. | 

Disk Write 

Format: 

W <disk#>, <block>, <#blks> <addr> RETURN 
The parameters for Disk Write are the same as those for Disk 
‘Read, above. The contents of memory starting at <addr> are 
written to the specified disk blocks. 
Example: 


W6,190,2,100900 RETURN 


The memory block starting at location $199090 is written to 
blocks 1998 and 181 of the left-hand floppy disk. | 
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Dump Memory 
Format: 
D <addrl> [,<addr2>] RETURN 
Where: 


<addrl> and <addr2> are hexadecimal numbers 
specifying the range of memory to be dumped. 


The Dump command outputs the contents of memory to the 
screen. The information is displayed in hexadecimal and 
ASCII. Sixteen bytes are displayed on each line of the 
screen. 


<addr2> is optional. If included, it must be separated 
from <addrl> by a delimiter, such as the comma shown above. 
As mentioned earlier, a space or a colon are also valid 
delimiters. 

If <addr2> is greater than <addrl>, then the range of 
memory will end at location <addr2>. Since sixteen bytes are 
always displayed on each line, a few bytes past <addr2> may 
also be displayed. | 

If <addr2> is less than <addrl>, then <addr2> is taken 
as the number of bytes to display, rather than the last 
address to display. 

Examples: 

D490@ RETURN 
dumps sixteen bytes, beginning at address 4909 (hex). 

D4000.4FFF RETURN 
dumps all bytes between addresses 4908 and 4FFF, inclusive. 

D4900.20 RETURN 


dumps 32 (20 hex) bytes, beginning at address 4999 hex. 
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Evaluate Math Expression 

Format: 

2? <integer expression> RETURN 
This command parseS an integer math expression and returns 
the result in decimal and hexadecimal. All numbers in the 
expression are assumed to be in decimal, unless they are 
preceded by the dollar-sign character ($), in which case they 
are interpreted as hex. 
Examples: 

210 * (147/3 -5) + 19 RETURN 

21998 - SFE@6 RETURN 

?S14A66 & SIFFF RETURN 

2(32+756) ! 1824 RETURN 

2?'HI' + 'ABC' RETURN 
NOTE: 


In the examples above, spaces have been included 
for clarity. Spaces must NOT be entered when 
typing expressions into the Monitor, since a space 
is a delimiter, and evaluation will terminate when 
the space is reached. 


In the third example, the Logical And operator (&) is 
used. This operator performs a 32-bit logical AND. The 
fourth example contains the 32-bit logical OR operator (!). 


The last example shows that strings may be used as 
operands. Up to four characters may be used in a string 
constant, Since the maximum number size in this system is 32 
bits. 

NOTE: 


All decimal* numbers, as well as any multiplies and 
divides, must be limited to 16-bit accuracy. 
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Examine Registers 
Format: 
X [<Reg>] [,<value>] RETURN 
Where: 
<Reg> is the name of a register, or a question mark 
<value> is a hex number, up to 32 bits 
This command allows you to examine or modify the contents of 
the 689908 processor registers. These are the names of the 
registers: 
DO Data register 9 
D1 Data register l 


D7 Data register 7 

Ad Address register @ 
Al Address register 1 

A7 Address register 7 

PC Program counter 

US User stack pointer 


SR Status Register 


If the command X is used with no arguments, the values of 
all registers are displayed. 


If the name of a register is oevERe only the value of 
that register is displayed. 


If the name of a register is given, and a value is 
Specified, the register is loaded with that value. 


If the question mark is used instead of a register name, 
a list is printed of the registers designated for Trace (see 
Trace Display). 


Page C-12 | : 7 Version 1.4 


Appendix C 7989 Operator's Manual Examine Registers 


NOTE: 


These registers are "pseudo-registers" used by the 
Monitor during trace and breakpoint operation. The 
values in these registers are not initialized 
unless a breakpoint is reached, Or unless 
specifically loaded using the X command. 


Examples: 


X RETURN 


XD1 RETURN 


XD1,3E4F RETURN 


X? RETURN 
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displays all registers 
displays the value of Dl 
loads Dl with hex value 3E4F 


displays registers designated 
for trace 
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Fill Memory 
Format: 
F <addrl>, <addr2>, <value> RETURN 
Where: | 


<addrl> and <addr2> are hex numbers specifying 
the memory range to fill; 


<value> is the hex number (8 bits or less) to 
fill with. 


Memory locations between addresses <addrl> and <addr2>, 
inclusive, are filled with <value>. 


Examples: 
F4000,4FFF,A5 RETURN 


This example fills locations 4990 through 4FFF (hex) with 
the value A5 (hex). 
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Go (with Breakpoints) 
Format: 
G [<addr>] [,<bkpl>] [,<bkp2>] RETURN 
Where: 


<addr> are each 32-bit hex addresses 
<bkpl> 
<bkp2> 


Go causes execution to begin at address <addr>. If <addr> is 
omitted, execution begins at the current value of PC. 


Up to two breakpoint addresses may be specified, and 
they must be separated by delimiters (commas, spaces, or 
colons). Execution will continue until any one of the 
breakpoints is hit. At that time, the registers designated 
by Trace Display will be listed, and control is returned to 
the Monitor. 


When either breakpoint is encountered, BOTH breakpoints 
are removed from memory. 


If no breakpoint addresses are specified, the program 
will not return to the Monitor (unconditional Go). 


Examples: 


G45@2 RETURN Go at address 4592 hex. 

GE6A2,E6B@ RETURN Go at address E6A2, with a breakpoint 
at EOBO. 

G,1l16FFQ RETURN Go at current PC, with a breakpoint at 
16FFO. 

G RETURN Unconditional Go. 
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Load 

Format: 

IL [<optional offset>] RETURN 
The Load command accepts input from Logical Input Device l, 
normally the RS-232 serial port. The input is expected to be 
Motorola 68999 object code in the standard format. See the 
68000 processor literature for format details. 
The code is loaded at its normal address in memory, unless — 
an offset address is specified in the load command. If 
specified, this offset is added to the memory addresses. 
Examples: 

L RETURN 


L1989 RETURN 
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Move Memory 
Format: 
M <addrl>, <addr2>, <addr3> RETURN 


Where: 


<addrl>, <addr2>, <addr3> are hex numbers 
specifying memory addresses. 


The contents of memory between locations <addrl> and 
<addr2>, incluSive, are copied to consecutive locations 
beginning at <addr3>. 


Example: 
M4000,4FFF,50990 RETURN 


The contents of memory locations 4999 through 4FFF (hex) are 
copied to locations 5999 through 5FFF. 
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Punch 
Formats 
P <addrl>, <addr2> RETURN 


The Punch command transmits output to Logical Output Device 
l, normally the RS-232 serial port. The output is in 
Motorola 68898 object code format. It contains all bytes 
between addresses <addrl> and <addr2>, inclusive. 


Example: 
P1900,2FFF RETURN 


NOTE: 


The Punch command does NOT produce the standard 
end-of-record marker on its output. See the End 
Punch command below. 


End Punch 
Format: 
E RETURN 


The Punch command produces output records in standard 
Motorola 68899 object code format. The Punch command does 
not produce the required end-of-record mark. To properly 
close out the object code, use the End Punch command. 


Example: 
E RETURN 


This command is provided separately so that you may Punch 
several different portions of memory to your output device, 
keeping them all as part of a single file, then terminate the 
entire set with one end-of-record using End Punch. The 
resulting object code can all be read in with one Load 
command, even though parts of it may be loaded into 
non-contiguous areas of memory. The Load command continues 
to read until it reads the end-of-record provided by End 
Punch. | 


Page C-18 . Version 1.4 


Appendix C 7998 Operator's Manual Set Memory 


Set Memory 
Format: 
SB <addr>, <string of values> RETURN 
SW <addr>, <string of values> RETURN 
SL <addr>, <string of values> RETURN 
Where: 
<addr> is the first location to set 
<string of values> is a list of hex values separated 
by commas, or an ASCII string in 
single quotes (SB command only) 
Use the SB command to set bytes, SW for words (16 bits), and 
SL for long words (32 bits). You can set consecutive 
locations by entering several values. The only limit is that 


the entire command must fit on one line of the screen (85 
characters). 


The string of values may be an ASCII character string, 
when uSing the SB command. The SW and SL commands will only 
accept hex arguments, separated by commas... 


Examples: 


SB4990,1E RETURN 
SW4019,12AE,1B67,FF,9C@8 RETURN 
SL6FO00,E34F91,0,2E,A5A5A5 RETURN 


SB5021,'This string goes into memory.' RETURN 
The apostrophe character (Single quote) is used to delimit 
an ASCII string. It is possible to insert a single quote 
into memory by entering two of them: 

SB490G,'It''s easy to do that!' RETURN 


A single apostrophe will be inserted between the t and s. 
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Trace 
Formats: 
T [<addr>] RETURN 


The Trace command executes one instruction in the program. 
The current instruction is pointed to by the register PC 
(program counter). After executing one instruction, the 
designated registers are displayed. 


Before using Trace, it is necessary to set PC using the 
"X" command (unless PC already contains a value, from a 
previous command). 


If <addr> is specified, tracing continues until that 
address is reached. The registers are printed after each 
instruction executes. The process may be interrupted at any 
time by pressing DELETE or by preSSing any Bezel Key. 
Pressing CTRL S will pause the display, and pressing another 
key will resume tracing. 


Examples: 

T RETURN 

T41E2 RETURN 
After using the Trace command, the next Monitor prompt you 
receive will be "TM" to indicate that you are still in trace 
mode. When you receive the "TM" prompt, you may press the 
RETURN key to execute a Single instruction. Entering any 
other command will remove you from trace mode, and the "TM" 
prompt will no longer be presented. 


See also Trace Display. 
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Trace Display 
Formats: 
[ <list of registers> RETURN 
[ ] RETURN 
[ @ RETURN 


Trace Display defines which registers will be displayed 
Guring Trace or Breakpoint execution. 


Each register in the <list of registers> must be in the 
following form: 


Reg . Length 


Where Reg is the name of a register, and Length is the type 
of display desired: B for byte, W for word, L for long word. 


The second format given above causes a listing of all 
registers to be printed at each break in execution. The 
third format turns off all register listing. 

Examples: 

[D8@.B,Al.L,A2.L RETURN: 

[PC.L,D1.W RETURN 

[] RETURN (display all registers) 

[@ RETURN (display none) 


A list of the registers currently specified for tracing may 
be obtained with the command: 


X? RETURN 
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Virtual Search 
Formats: 
V <addrl>, <addr2>, <string of values> RETURN 
Where: 


<addrl> is the start of the memory range to search 
<addr2> is the end of the range 
<string of values> is what to look for (hex or ASCIT) 


The range of memory between <addrl> and <addr2>, inclusive, 
is searched for the string. If a match is found, the 
locations containing the match are displayed. 


Examples: 
VG ,1900,FF RETURN | 
V40090,8900,0,89,09,8 RETURN 
VO ,FFFF,'Find me' RETURN 


In the first example, a search is performed for all 
occurrences of the value FF hex between addresses @ and 1909 
hex. In the second example, the range 49990 hex to 8000 hex 
is searched for four consecutive zero bytes. In the third 
example, the command searches the entire first 64K of memory 
(addresses § to FFFF) for the ASCII string "Find me." As with 
the S (Set Memory) command, an apostrophe may be entered in 
the ASCII string by typing two apostrophes. 


The Virtual Search command may be used to determine the 
revision level of the PROM software in your 7909 system. 
Execute the Monitor, and type the following command: 


V8090000 8OFFFF 'VER#' 


This command searches addresses $890000 through S8@OFFFF (all 
PROMS) for the character string. 'VER#'. PROM software 
versions 1.1% and later contain this character’ string, 
followed by the version number, for each major program in the 
system. In version 1.4, the following would be displayed: 


VER# TERMEM 1.4 
VER# Monitor 1.3 


This indicates that the system contains version 1.4 of 


TERMEM (the Terminal Emulator) and version 1.3 of the 
Monitor. These are the latest versions. 
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Appendix D -- Traps 


The MC6889@ processor used in the CGC 7988 will detect a 
number of error conditions which may occur during a program. If 
a severe error occurs, the processor discontinues normal program 
execution and "traps." This causes the 7998 software to display 
information relating to the trap, and the system halts. A 
"crash" sound indicates that the program has crashed. The red 
indicator above the cursor keypad is illuminated. 


Traps should not be encountered during normal operation. 
Users running preliminary or un-debugged software are more likely 
to encounter traps. 


When the system traps, the bottom line of the Overlay 
displays the type of trap, the address at which the trap 
occurred, and seven words of data from the stack. These data may 
be helpful in determining the reason for the trap. When 
contacting Chromatics for assistance regarding a trap problem, 
please include all of the data displayed at the time the trap 
occurred. 


After a trap, the system stops and does not acknowledge 
interrupts. The only way to recover from a trap is to press 
RESET, PresSing RESET turns off the red indicator on the 
keyboard; however, the trap message remains on the screen until 
erased. Pressing RESET followed by SOFT BOOT will clear the 
screen and recover from most traps. 


If the program damaged any system data before trapping, it 
may be necessary to force a power-up Boot by pressing CTRL SHIFT 
RESET. 


Traps are explained in more detail in the Motorola MC6899@ 
User's Manual (available from Chromatics). . 
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Traps are referenced by a number or a letter: 


Trap type Explanation 


Qg Bus Error (non-existent memory was accessed). 


1 Address Error 


(attempt to fetch word data from an 


odd memory address). 


2 Illegal Instruction. 
3 Division By Zero. 
4 CHK Instruction. 
5 TRAPV Instruction. 
6 Privilege Violation (attempt to execute privileged 
instruction while in User state). 
7 Trace. 
8 Line 1919 Emulator (illegal instruction). 
9 Line l1lll Emulator (illegal instruction). 
A | Spurious Interrupt. 
B Level 1 Interrupt Autovector. 
C Level 2 Interrupt Autovector. 
D Level 3 Interrupt Autovector. 
E Level 4 Interrupt Autovector. 
F Level 5 faveerunt Autovector. 
G Level 6 Interrupt Autovector. 
H Level 7 Interrupt Autovector (power-up interrupt). 
P Buffer Memory Parity Error. 
* Undefined Trap. 
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Appendix E -- Custom Modules, Cursors and Character Sets 


This section discusses how to add custom features to the CGC 
7980: modules, cursors and character sets. 


Modules are commands which are loaded into memory (RAM or 
EPROM). When the system is booted, all modules are "“linked" 
together in a fashion which allows any of them to be executed by 
ASCII code sequences. All of the features implemented in the 
79986 are written as modules: this includes I/O drivers, Plot 
Submodes, Mode, Escape and User codes. Using the information in 
this section, the user can write modules which perform custom 
functions, and link them into the CGC 7998 system. 


Version 1.4 Page E-1 


Modules — 7999 Operator's Manual | Appendix E 


Modules -- General 


A module is a sub-program, written according to a list 
of guidelines so that it may be linked into the CGC 7909 
firmware. There are seven types of modules: 


Bs: Boot only. This module contains code 
which is executed at boot time, but not 
otherwise used by the system. 


Is Input device. This is a driver which 
interfaces a physical input device to the 
system. Currently defined "I" modules 
include the keyboard and serial ports. 


O: Output device. This is a driver which 
interfaces a physical output device to the 
system. Currently defined "O" modules 
include the serial ports, windows, and 
keyboard lights. 


Mode: Mode code. This module performs functions 
which modify the attributes of a window. 
The window software calls Mode modules 
when it receives a Mode code sequence. 


Plot: Plot submode. This module describes a 
Plot submode, and is called when a window 
receives a Plot code sequence. 


Escape: Escape code. This module is called by the 
Escape code processor when an Escape code 


sequence is received. Escape codes 
generally alter the status of the entire 
system. 


Users User code. This module is called by the 
Escape code processor when a User code 


sequence is received. User codes 
generally alter the status of the entire 
system, or cause execution of a 
controlling program (such as DOS or 
Idris). ) 
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Modules may exist in EPROM or in RAM. Most of the EPROM 
firmware in the 798@ consists of modules. For each Mode, 
Plot, Escape and User code sequence recognized by the 7900, 
there is a module in firmware which defines the actions taken 
by that code sequence. All modules in the system are 
"Linked" whenever: 


@e the system is powered-up; 
e CTRL SHIFT RESET is pressed; 
@ or when BOOT is pressed. 


The process of "linking" means that the system is 
scanned for modules, the addresses of all modules are loaded 
into dispatch tables, and any necessary initialization is 
performed. Note that this "linking" is done sequentially, 
through EPROM, then through any RAM modules which may have 
been loaded by the user. This means that two or more modules 
may define the same code sequence, and the LAST one linked 
will be the one in the dispatch table after linking is 
complete. This makes it easy for a user module to re-define 
a system function, with the module replacing the firmware 
module which has the same identifying code at its beginning. 


Mode, Plot, Escape and User modules may accept 
arguments. The required arguments are defined by the module, 
and the system automatically parses arguments before passing 
control to the module. This relieves the user from writing 
argument parsing routines, and inSures that all arguments are 
parsed in a consistent manner. 


A module must Save any registers it modifies, and 
restore the registers before exiting. As described below, 
several registers are pre-loaded before the module is 
executed and provide the module with system status 
information. 
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The Linking Process 


The system scans two areas for modules when linking is 
performed: first, each EPROM pair on the 79098 Raster 
Processor Board is checked. If a ROM Expander card is 
installed and its address is consecutive with the Raster 
Processor, firmware in the ROM Expander will also be checked. 
If an EPROM pair is installed, and if a valid module is found 
at the start of the EPROM, linking proceeds through the 
EPROM. Linking terminates when an invalid length descriptor 
or an invalid module type code (one not in the set B, I, O, 
etc.) is found. Linking then proceeds to the start of the 
next EPROM pair. 


After all EPROM modules have been linked, the system 
checks for RAM modules. RAM modules, if they exist, must be 
loaded into system RAM at the address pointed to by RAMMDLE. 
(RAMMDLE is a pointer in CMOS memory, and its contents may be 
altered with the "Thaw" command. See Chapter 6 for details.) 
The default address for RAM modules is S1F9@@; this allows 4K 
of space for modules, when a single Buffer Memory card is 
installed. 


If RAM modules exist, they must follow all the rules 
described in this section, with an additional provision: to 
indicate the presence of RAM modules, the bytes 'MDLE' must 
be loaded into RAM at the start of the first RAM module: 


ORG.L S1F OOO Org where Thaw wants us to be 
DC.L '"MDLE' Indicate RAM modules here 
etc. 


The bytes 'MDLE' must NOT be included if a module is being 
put into EPROM. 


Modules are expected to be "back to back," existing 
consecutively through memory. Thus, any tables or other data 
used by a module must be WITHIN the module, not after it. 

The last module should end with the following statement: 

DC.L -1,-l 


This indicates to the linker that no more modules follow. 
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Module Construction 


Each module begins with a length descriptor. The length 
is used to determine where one module ends, and where the 
next one begins. The address of each module is determined at 
boot time during the linking process, and loaded into a 
Gispatch table for future reference. 


Next, a module contains one of the characters B, I, O, 
Mode (CTRL A), Plot (CTRL B), Escape (CTRL [), or User 
(CTRL U), to define the type of module. This is immediately 
followed by a character which uniquely identifies that 
module. 


The makeup of the remainder of the module depends on the 
type of module you are writing. All of the seven types of 
modules are discussed in this section, and examples are 
provided. 


Version 1.4 . | Page E-5 


Boot Modules | 7999 Operator's Manual Appendix E 


Boot Modules 


A Boot module is executed upon power-up, when the system 
RESET key is pressed, or when the system is booted (by 
pressing BOOT). A Boot module might be written to initialize 
a piece of hardware, or to pre-load the Case Table for 
interfacing to a certain host computer. 


“The Boot module contains a length descriptor (word), the 
character 'B' followed by a dummy character, and the code to 
be executed. It ends with a RTS instruction. | 


ORG.L S1F9090 Org where Thaw says to Org 


DC.L '"MDLE! Required for RAM modules 
DC.W MdleEnd-IPC This is our length 
DC.B '‘'B',@ Identify a Boot module 

* 

* Boot code begins here... 

* 

* e 

* and ends here. 

* 
RTS 

MdleEnd EQU IPC 
DC.L --1,-1 Make sure linking ends here 
END 
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Input/Output Modules 


I/O modules define the interface between a physical 
device, such as a printer, and the logical device assignment 
structure in the 79968. The I or O module must be responsible 
for handling all transfers to or from the device, checking 
the status of the device (if applicable), and booting the 
device (if necessary). Note that the Boot section of an I or 
O module performs the function of a B module. 


The I or O module begins with a length descriptor 
(word). This is followed by the character I or O, defining 
an input or output module, and a character between A and Z to 
identify this particular I/O module. This character (A-Z) is 
used in the "Assign" command to identify the physical device 
which is being asSigned. 


Two words of code must follow the identifying character. 
These must be either SHORT branches to Boot and Status 
sections of the module, or RTS instructions. The Status 
section is used in an I module to see whether a character is 
ready to be read. The Status code should return the Z flag 
SET if no character is available, or clear it if a character 
is available. If the Status code returns Z set, the system 
will not execute the main code. (The Boot and Status 
portions of the module must also terminate with a RTS.) 


In an input module (type I), if input is being buffered, 
the Status code may return a "snapshot" of the oldest 
character in the buffer in D@.B. This feature is used by the 
STATIN routine in TERMEM, and is called by DOS to check for 
X-ON and X-OFF commands (to suspend output). Note that the 
character snapshot must not remove the character from the 
input buffer; the character should remain in the buffer until 
read by the main code of the I module. 


The Status section is not used in an O module. An O 
module must not return until it has completed processing a 
character. | 


The main body of the module follows, terminated by a 
RTS. The system passes a character to an Output module in 
register D@#, and expects an Input module to return a 
character in D@. The low 8 bits of the register are used. 


Note that a Single device capable of both input and 
output requires two modules, one I and one O. (Our device 
'Q' below may have an I module and an O module associated 
with it.) 


Version 1.4 | | Page E-7 


I/O Modules 


7988 Operator's Manual Appendix E 


* Sample Input module (type 'I') for a device named Q. 


* Main 


MdleEnd 
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ORG.L SIF OOD Org where Thaw says to Org 
DC.L | 'MDLE' Required for RAM modules 
DC.W MdleEnd-IPC Our length 

DC.B Ey tO" Input module for device 'Q' 
BRA.S Qboot 

BRA.S Qstat 

code for inputting a character from device Q. 


MOVE.B QObuffer,D9@ Get input data 

BSR Stompbuf Remove this data from buffer 
RTS 

for booting device Q. (Executed at Boot time.) 


MOVE.B #9,QCtrlPort Initialize device Q. 
MOVE.B #SFF,QCtr1lPort 

MOVE.L #QISR,Qvector Load interrupt vector 
RTS | 
for checking status of Q. 

TST .W QObufstat Check buffer status 
MOVE.B QObuffer,Ds Snapshot oldest character 
RTS 

EQU | IPC 

DC.L -1,-l No more modules here 
END 
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Argument Parsing 


The module types discussed below may have arguments 
associated with them. An argument is a set of characters or 
numbers which is passed to the module. Mode, Plot, Escape 
and User modules may accept arguments. The arguments 
required by a module are defined by that module, and are 
parsed by the system before the module is called. The module 
then simply picks up its arguments and processes them. 


The system will parse ten types of arguments: 


Arg type Description 
0: No argument, just a placeholder. 
Ll: A single character. 
23 A string of characters, delimited by a space, 


comma, or semicolon. 


33 A string of characters, delimited by a 
semicolon ONLY. 


4: A signed 16-bit decimal number (or a number in 
Binary Coordinate form, if the system is in 
Binary Mode). 

oie A 16-bit hexadecimal number. 


6: A decimal number, or the X component of a 
coordinate defined by the cursor. 


73 A decimal number, or the Y component of a 
coordinate defined by the cursor. 


8: An X-Y coordinate pair (combination of 6 and 
73; will accept a period for cursor position). 


93 Any number of coordinate pairs, delimited by a 
semicolon. 

A: A decimal number, scaled but without 
translation. 


Argument types 6 through 9 are designed to parse 
coordinate data. Each of these will scale and translate 
arguments according to the scale factors in use in the window 
which executed the module. 
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In defining arguments, the system looks for two words 
immediately following the module's name. Up to eight 
argument types may be placed in these words. If no arguments 
are to be processed, fill both words with zero. 


Peculiarities of each type of module are discussed 
below. 
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Register Setup for Modules 


When a module 


is executed, several registerS are 


pre-loaded for convenience. The following table defines what 
each register is used for, when each type of module is 


entered. 


Module 

B (boot) 

I (input) 
O (output) 


Mode, Plot 


Escape, User 
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Ag: 


Al: 


A3: 


D7: 


Ag : 


Als: 


D7: 


Register Usage 
No registers pre-loaded. 
No registers pre-loaded. 
No registers pre-loaded. 
Points to base of Window Table for 
the window which called the module 


(see Window Table description). 


Points to Mode arguments (parsed 


before module execution begins). 


Points to Plot arguments (parsed 
before module execution begins). 


Contains window status for the 
window which called the module (see 


- Window Table description). 


Points to base of the Window Table 
for window A (the Master Window). 


Points to arguments (parsed before 
module execution begins). 


Contains window status for window A 
and Escape code status. 
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Mode Modules 


A Mode module is executed when a window receives the 
Mode code sequence identifying that module. Mode modules are 
expected to affect only the window which called them, 
although nothing in the system will prevent a Mode module 
from affecting other windows or other aspects of the system. 


A Mode module consists of a length descriptor (word), 
followed by the MODE character (CTRL A, decimal 1), and a 
character which uniquely identifies the module. This 
character may be any ASCII character above '@9' (hex $39). 


The next long word in the Mode module defines a list of 
arguments, to be parsed and passed to the module. Each 
nybble (4 bits) of the long word specifies one of the ten 
argument types listed above. 


The argument list in this long word is right-justified, 
and the least-significant nybble defines the FIRST argument 
to be parsed. The long word must be left-filled with zeros 
to indicate the end of the argument list. Up to 8 arguments 
may be defined in this long word. 


Examples: 


DC.W MdleEnd-IPC Length Descriptor 
DC.B Mode,'L' . Name of Mode module 
DC.L $@8000144 Argument list 


This list would specify that the module requires two decimal 
numbers, followed by a single character. 


Arguments to a Mode module are put onto the “Al stack." 
That is, the Mode module may assume that itsS arguments are 
waiting for it at the address pointed to by (Al), and 
successive bytes. The stack may contain up to 16 long words. 
MODE codes are processed when they reach the screen (or other 
physical device). 
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Example Mode Module 


KKK KKK RRR KKK EK KR KEKE RK REAR REAR ERE IKE ERR 


* * 
* This sample Mode module does the same thing as * 
* the TERMEM Fill ON/OFF command (MODE F 1/8) = 


* * 
RRKKKKKKKEKEKEKEKEEKKKEKREKEKKKEKKEEKEKEKRKKKKKEKKEEKKKKKKRRKEKEKEKEK 


ORG. L S1F O00 Org where Thaw says to Org 
DC.L "MDLE' Required for RAM modules 
DC.W FillEnd-IPC Length descriptor 
DC.B Mode, 'f' Name of module 
Mode EQU 1 (Mode is Control-A) 
Fillon EQU 8 Bit 8 in D7 
DC.W SGOBO Our arg list 
DC.W SOOG1 (just one character) 
* 
* Code for module "MODE £" begins here. 
* 
* The user would type MODE f <n> 
* 
* where <n> is either @ or l. 
2 : 
* 
CMP.B #'O',(Al1) Get the flag 
BEQ.S FillOff If it equals zero, kill Fill 
BSET #Fillon,D7 Else turn it on 
RTS Then quit 
FillOff BCLR #Fillon,D7 Turn off Fill mode 
RTS 
FillEnd EQU IPC 
DC.L -~l1,-1 Only if no more modules 
END 
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Plot Modules 


A Plot module performs a graphics function. All but one 
of the plotting features in the 7999 firmware are written as 
Plot modules. Plot modules generally accept coordinate data 
aS arguments, and perform some plotting function based on 
this data. The “linking” procedure used for all modules 
means that you can write your own Plot modules, link them in 
to add new features to the 79898 firmware, or replace any 
existing features. Plot codes, like Mode codes, are 
processed when they reach the current output device. 


Plot modules begin with a length descriptor (word). This 
is followed by the PLOT character (CTRL B, decimal 2) and a 
character which identifies the module. The identifier may be 
any character above ASCII "@" (hex $40). 


The next two words specify arguments to be passed to the 
Plot module. The FIRST time a Plot module is entered, it may 
need to execute a special sequence of instructions’ to 
initialize itself. A status bit tells the module whether it 
is being entered for the first time, or on subsequent calls. 


The second word of the argument list is used to select 
arguments for the first call. The first word selects 
arguments for subsequent calls. 


Once a Plot code sequence has been entered, execution of 
the Plot module begins. The module can then be repeatedly 
called; it will be executed automatically when it has enough 
arguments. 


Example: 


DC.W ModEnd-IPC 
DC.B Plot, 'Z' 


DC.W $9611 Two chars for repeated calls 
DC.W $0888 Coord arg for first call 


In this example, the Plot module requires a coordinate 
argument when it is first executed. After the coordinates 
have been entered, the system will accept two single 
Characters before entering the module (this is the argument 
scheme used by Incremental Vector). 


This process continues until another Plot submode is 
entered or until the user turns Plot mode off. 
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On entry to the Plot module (and other modules), certain 
registers are set up for convenience. One of these is D/7, 
which contains the window status. The "Submode"™ bit of D7 
(bit 17) is set when a Plot module is first entered, to 
indicate that "this Plot Submode was just entered." If a Plot 
module cares about whether the submode has just been entered, 
it must check. this bit and perform any necessary 
initialization if the bit is set. Then, it must clear the 
"Submode" bit. 


If the Plot module does not do anything special when it 
is first entered, duplicate the argument list in the first 
and second word: 


DC.B Plot,'Z' 
DC.W SOGB8B A coord for repeated calls 
DC.W $8068 and also for the first call. 


Note that Plot modules may only parse FOUR arguments before 
execution begins; Mode modules could have up to eight. 


To prevent conflicts between Plot code and Mode code 
arguments, Plot arguments are stacked on the "A3 Stack" and 
may be picked up from the addresses pointed to by A3. The 
module must not alter A3 or any other registers. Up to 32 
long words are allocated for Plot module arguments. 


Remember that more than one window at a time may be in 
the same Plot Submode. A Plot module should not store any 
local data which could interfere with another window calling 
the Plot module. Local data should be stored in the window 
table, or otherwise be localized to the window. 
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Example PLOT Module 


* 


* An example of how a Plot module should be set up. 
* 

ORG. L SIF OGG 

DC.L "MDLE' 


DC.W § ModEnd-IPC 
DC.B Plot,'2' 


Plot EQU 2 (Plot is Control-B) 
DC.W $8008 One coordinate pair normally, 
DC.W $8088 Two pairs the first time through. 

Submode EQU 17 
BTST #Submode,D7 Did we just enter the submode? 
BEQ.S Norm No, it's a normal entry 

* 

* Submode was just entered. We can set up 

* in this block of code if necessary. 

* 
BCLR #Submode,D7 Prepare for next entry 

* 

* (Setup code goes here) 

* 
RTS 

: | 

* 

* Come here if submode was NOT just entered. 

* 

* 

Norm MOVEM.L D@-D2/A3,-(SP) Save registers 
MOVE.W (A3)+,D@ Get X argument into D@ 
MOVE.W (A3),D1 Get Y argument into Dl 


Now, do something with the arguments here.... 
Maybe plot a vector or something. 


+ + % % 


MOVEM.L (SP)+,D@-D2/A3 Restore registers 
RTS 
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Escape and User Modules 


Escape and User modules are identical to each other, and 
are Similar to the Mode modules discussed earlier. An Escape 
or User module begins with a length descriptor (word), 
followed by the ESC ($1B hex) or USER ($15 hex) character, 
and a single ASCII character which identifies the module. 
The identifier may be any character above ASCII '@' (S49 
hex). 


The next two words define an argument list, exactly like 
a Mode module. All arguments (up to eight) are parsed by the 
Escape Code Processor and are passed to the EScape or User 
module. Arguments are found on the Al stack (pointed to by 
Al). This does not conflict with the stack of Mode arguments 
because Escape and User codes are processed by a different 
routine than Mode codes. 


Remember that Escape and User codes have identical 
priority in the 7998 code processing scheme. Escape and User 
modules are not specific to a window, so they should be used 
to implement functions affecting the entire machine. Escape 
and User codes are trapped and processed by the Escape. Code 
Processor. 
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Example ESCAPE code Module 


* 


* A sample Escape code module to play with the 
* lights on the keyboard. This could also have 
* been written as a User module. 
* 
ORG.L SIF OOD 
DC.L "MDLE! Identify a module is here 
DC.W | MdleEnd-IPC Length descriptor 
DC.B ~~ Esc, 'X'! Escape X iS our sequence 
Esc EQU S1B 
DC.W SOOBD 
DC.W SO004 We want one decimal # 
MOVE.W (Al) ,Keybrd Send it to the keyboard 
Keybrd EQU SFF8880 (Keyboard address) 
RTS | | 
MdleEnd EQU IPC 
DC. L -1 pol 
END 


Page E-18 | Version 1.4 


Appendix E 7908 Operator's Manual Window Tables 


Window Tables 


512 bytes of data are allocated as a Window Table for 
each active window. These bytes hold the current status of 
the window, including such items as color, blink, scale, 
window limits, and most other window attributes. Window 
attributes are usually set by Mode code sequences, and Mode 
modules will often want to alter items in a Window Table. 


The following chart lists the location of each item in 
the window table, by giving an offset into the table where 
each item may be found. An item can be altered by a module 
by using the listed offset as a displacement from (A@), since 
A@ is pre-loaded with the base of the Window Table. 


Example: 


FrgCol EQU S8E Offset in table 
for Foreground color 


MOVE.W FrgCol(A@) ,Dd Get color into D@ 
In this table, entries are marked with .B, .W, or .L, to 


indicate the appropriate data size (where possible). 


$00 .L TVALUE: Temporary storage area (reserved) 
$04 .L Arglst: Mode argument list 


$08 .L Parglst: Plot argument list 

SOC .L STATUS: copy of D7 status long word 
$10 .L “Argstk: pointer to Mode argument stack 
$14 .L Argdsp: Mode dispatch address 

$18 .L “Prgstk: pointer to Plot argument stack 
S1c .L Prgdsp: Plot dispatch address (submode) 


Window variables are stored beginning here 
and occupy one word each. 


$20 .W Window Variable A 
$22 .W Window Variable B 


S5C .W Window Variable _ 
SSE .W Window Variable ~ 
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The following items are also Window Variables a-z 


$69 
$62 
$64 
$66 
$68 
S6A 
S6C 
S6E 
$79 
$72 
$74 
$76 
$78 
S7A 
$7C 
STE 
$80 
$82 
$84 
$86 
$88 
S8A 
S8C 
S8E 
$90 
$92 


$94 
$96 
$98 
SOA 
$9C 
SAD 
SA4 
SA8 
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SSSS3 S533 3355335555255 


BH== = 


ow 


AcursX: 
AcursY: 
CursxX: 

CursY: 

Awindxg@ 
AwindyYyg@ 
Awindxl 
AwindYl 
WindxX®@: 
WindY@: 
WindXxl: 
WindYl: 
CharxXZ: 
CharYZ: 
CharDX : 
CharDY: 
CharXM: 
CharYM: 
XVmins: 

YVmin: 

Tabcol: 
Vecwlds: 
BkgCol: 
FrgCol: 
PlaneEs: 
CursCol 


but are used for system data as well. 


Overlay cursor X position 

Overlay cursor Y position 

Bitmap cursor X position 

Bitmap cursor Y position 

Overlay window upper left corner X 
Overlay window upper left corner Y 
Overlay window lower right corner X 
Overlay window lower right corner Y 
Bitmap window upper left corner X 
Bitmap window upper left corner Y 
Bitmap window lower right corner X 
Bitmap window lower right corner Y 
Character X raster size 

Character Y raster size 

Character delta X after write 
Character delta Y after write 
Character X multiplier 

Character Y multiplier 

Virtual X minimum value 

Virtual Y minimum value 

Tab stop spacing 

Vector width 

Background color 

Foreground color 

Planes enabled 

Cursor color (not used, reserved) 


Some miscellaneous items... 


Oldx: 
O1ldyY: 
XScl: 
YScl: 


Charadr: 


Endbuf : 


Plotdot:. 


Rubber band X position 

Rubber band Y position 

Virtual X Scale value 

Virtual Y Scale value 

Character set base address 

End of arguments for virtual coordinate 
Dispatch address for dot plotting 


Plotvect: Dispatch address for vectors 
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The following five items are used for 
raster processor operations in the window. 


SAC .W WXsrec: X source raster operating point 
SAE .W WYsrc: Y source raster operating point 
SBO .W WDXsrc: Delta X for source raster 
_$B2 .W WDYsrc: Delta Y for source raster 
SB4 .W Wetrl: Control bytes for rasters 


The next three items are for argument storage. 


$B6-SF5  Curstg: 32 words for cursor pixel storage 
SF6-$135 Argstk: Argument stack for Mode args (32 words) 
$136-S1B9 Pargstk: Argument stack for Plot args (64 words) 


The following four bytes contain the current 
Overlay color, blink and transparency attributes. 


S1BA AentSt: Transparency 

S1BB AentBC:. Background color 

S1BC AentFC: Foreground color 

S$1BD AentCh: ASCII character position 
S1BE-S1FF Reserved for future expansion 
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Window Status and ESCAPE Code Status 


As shown before, 
information when certain types of modules are executed. 


register 


D7 is pre-loaded with status 
The 


bits in D7 are defined as follows: 


Bit 


WO DONA & WDNEH & 


Bit @ 


is 


reserved. 
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the 


Name 


modeF : 
plotF: 
Moredat: 
Negnum: 
visctrl: 
Pltmode: 
Overlay: 
Cursons: 
Fillon: 
Blinkon: 
Rollon: 
OvrStrk: 
Binmode: 
Rubrons: 
Patton: 
Submode: 
Cursin: 
BinTwo: 
vScale: 
Avon: 
Local: 
Full: 
Escflg: 
Usrflg: 
Create: 
LitP@: 
LitPl: 
Literal: 
Escdone: 


least 


Meaning 


Mode flag used by window processor 
Plot flag used by window processor 
Control bit used by argument scanners 
Control bit used by argument scanners 


SET when 
when 
when 
when 
when 
when 
when 
when 
when 
when 
when 
when 
SET when 
Flag for 
SET when 
SET when 
SET in 
SET in 
Escape 
Escape 
SET if 
Escape 
Escape 
SET if 
Escape 


Significant bit. 


visible ctrls are on 

in a plot submode (not alpha) 
Overlay on (not Bitmap) 
cursor is on 

fill is on 

blink is on 

roll is on 

overstrike is on 

binary mode is on 

rubber band is on 

patterns are on 

Plot submode just entered 
Bitmap cursor in screen RAM 
binary coordinate parser 
scaling is on 

A7 character set active 


LOCAL mode 
FULL duplex 
code processor 
code processor 
Create is on 
code processor 
code processor 
Literal Create 
code processor 


flag 
flag 


flag 
flag 
is on 
flag 


Unused bits are 
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Custom Character Sets 


The 7908 allows user-defined character sets to be used 
in the Bitmap in place of the two character sets supplied 
with the system. An entry in each Window Table (Charadr) 
points to the base of the character set for that window, and 
the size of the font (X by Y pixels) may also be defined for 
each window. The character font dimensions may be up to 16 
in the X direction, and 256 in the Y direction. 


Since the character set address for a window is stored 
in the Window Table, it will default back to the normal 
character set whenever BOOT or SOFT BOOT is executed. : 


The character set for the Overlay is stored in 
high-speed PROM, and is not alterable through software. 


The following program is a module, designed to be linked 
into the 7996 system software. It will install a custom 
character set in any window which receives a MODE i command. 
This program is an example ONLY. It does not include a 
complete character set definition. The data set which should 
accompany this program would be too long to fit into the 
standard 7990 memory, unless you do one of the following: (1) 
change the ORG address, which requires changing address 
RAMMDLE with the Thaw command, (2) change the height of the 
Character set to reduce the data required, or (3) install 
additional memory above address $20000. 
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Sample module to install a new character set. 
The set is installed in a window by the command: 


MODE i X, Y, <addr> 
To return to the standard set, use SOFT BOOT. 
HHH RIK IK KIKI KIKI KK KAKA KERR KERRI KERR KEEREREREERER EK 
What follows is the character font definition. 


It is arranged as 128 regular characters, followed by 128 
A7 characters. All 256 characters should be defined. 


Assume the font is set in a field X by Y. (Default is 
X = 6 and Y = 8.) Then each character requires 8 words 
of data, one for each Y scan; and 6 bits of each word 
are used. The active 6 bits are left-justified in the 
16-bit word. 


Example: the character "A" 


bit # 
111111 Hex value 
5432189876543219 
l > >.> rar aa ee ar $700G 
2 Koes Rose oe Soe ee S880 
3 ib ash dew terete. 6 eee are S880@ 
Word # A SRR KK iaseteeaas SF8 00 
(one per Y scan) D Keech vaweeees eee $8890 
6 > Par nen> Crane re tan eran ar ae $88d0@ 
1 Keawwd ee bee ewes $8800 
GO wuelenerdvexesece- erase ecece SQGHD 


The X by Y field must include any necessary 
Spacing between characters or between lines. 


Memory requirements: 


This module will require 256 * Y words. 

This much memory must exist between address 

"RAMMDLE“ and the physical end of memory. 

If necessary, use Thaw to alter the address of "RAMMDLE" (be 
Sure to put it where nothing will stomp on it!) 


a ee 2 
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* 

A | 

* This Scale Factor will left-justify a 6-bit number in a 

* l6-bit field, by shifting 18 bits. All of the numbers in 
this database are 6-bit for convenience, and S justifies 
. them properly. 

* 


S EQU 1924 

* 

* 

BASE ORG.L <known address> This is where it all begins. 
z 7 

* This is the regular character set. 


* 


DC.W $24*S,$34*S,S3C*S,S2C*S,S24*S,S84*S,SG4*S,SO7*S “@ 
DC.W SO@C*S,S19*S,$88*S,$85*S,S1D*S,$07*S,$05*S,SG5*S “A 


= > etc. for regular set. 


DC.W $01*S,SBE*S,S19*S,SO0*S,SG0*S,SO9*S,SB9*S,SOB*S . 
DC.W SG@A*S,$15*S,SGA*S,S15*S,S9A*S,S15*S,SGA*S,SOB*S DEL 


* 

* 

* 

* 

- Alternate (A7) character set begins here. 

* 
DC.W S1F*S,$15*S,$15*S,S1F*S,$15*S,S15*S,S1F*S,$0G*S “@ 
DC.W $08 *S,$15*S,$02*S,$88*S,$15*S,$82*S,S90*S,S0G8*S “A 

* 

. ° etc. for A7 set. 


DC.W $01*S,$82*S,S02*S,SH4*S,$08*S,S19*S,S19*S,S2HB*S - 
DC.W SO0*S,S80*S,SOG*S,SOG*S,SO0*S,SOO*S,SO9*S,S3F*S DEL 


END 
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Vector-Drawn Character Format 


The command format for vector-drawn characters is on 
page 9-26. These characters are formed by a vector list, 
which is an arbitrary number of short (bold) vectors. All 
printable characters from the exclamation point ($21 hex) 
through the tilde (~, $7E hex) are described by entries in a 
vector list. The list is pointed to by a long word in CMOS 
called VChrset, address SE4921E. VChrset will normally point 
to the default vector list in PROM, but it can be altered to 
point to a custom set. 


Each vector-drawn character lies within a 16 x 16 
matrix. The cursor is assumed to be at the upper left corner 
of the matrix, so the matrix points are numbered (in 
hexadecimal) : 


912345678 9ABCDEF 


Tittle «§ POH & 


Within the vector list, each 16-bit word defines one vector 
of the character. Four bits each are used for Xl, Yl, X2 and 
Y2 for that vector. For example, consider the letter H: 


912345678 9ABCDEF 
1) a ea a ree mre ae 
LX cccccccceXcenes 
eG toxiahoveve.eilere ee oceese 
BX ie eoc¥ bed wk Gece 
Kes a es Wcaae De ale es te 
SXXXXXXXXXXX.e wee 
ea ee ae ee, eee 
TXawcccccccXeccce 
CXeeccsssecXesees 
“? ae eee ea Sree 


AXcccccccceXeccce 
Bocce cccvccccccce 
Coe es 6-00 #0058 6006-6 
2 ee ee ar eee ee ea 
Ee euacte ener ale alee Selatan 


Fo! oho. Sub ave: & ee ees 
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In the diagram, Xs correspond to points to be drawn in 
the character. Three vectors are needed: from 9,8 to Q@,A; 
from @,5 to A,5; and from A,@ to A,A. The vector list for 
this character would be: 


SOOOA 
S@5A5 
SAGAA 
SOGBD 


The zero word signals the end of the list for that 
Character. The definition for each character may contain an 
arbitrary number of vectors. 


The default character set only uses part of the 
available 16 by 16 matrix. Most characters in the default 
set fit within an 8 by 12 matrix, including lower-case 
descenders. If you use a "non-standard" size, the Set 
Intercharacter Spacing command will force the proper spacing. 
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Algorithm Description 


When told to produce a character, TERMEM scans the 
vector list starting at the address in VChrset. It assumes 
that the description for the exclamation point character ($21 
hex) is at the start of this list. Then it scans forward, 
looking for the zero words that separate the character 
descriptions, until the correct character is reached. 


Each data word describing the character is separated 
into the four-bit values for Xl, Yl, X2 and Y2. These values 
are multiplied by the current xX and Y character size 
parameters in the Window Table. Then, the coordinate data is 
rotated according to the angle given in the Vector-Drawn 
Character command. The current cursor position is added to 
these rotated XY values, and a bold vector is drawn in the 
current foreground color and vector width. This process is 
repeated until the terminating zero word is found in the 
vector list. | 


Next, the cursor location is updated. If proportional 
Spacing is ON, the largest X value in the character list plus 
2 is used (this implies that the characters must be 
left-justified in the 16 by 16 matrix for proportional 
Spacing to work properly). If proportional spacing is OFF, 
the current X intercharacter spacing is used. In either 
case, this value is multiplied by the current X character 
Size, rotated and added to the current cursor position. 


The Space character does not have a descriptor in the 


vector list, so the current intercharacter spacing is used to 
update the cursor position. 


Page E-28 | | Version 1.4 


Appendix §E 7968 Operator's Manual Custom Characters 


The following DOS program fragment will load a custom 
vector-drawn character set. Since VChrset is in CMOS and the 
vector list is in RAM, you will have to either save the 
default value of VChrset and restore it at the end of the 
program, or press CTRL SHIFT Ml M2 RESET to return to the 
default character set. 


RHREKKKEKEKKKKKKEKKKEKKEKRKKEKKKEKKEKRKEREKRREKEKKKERKEEKERKEEKREKREKKEKEKRRKRKRKKRKEESE 


VChrset EQU SE4921E pointer to data set 
ORG. L S$1C3C run in DOS area 

Start MOVE.L VChrset,-(SP) save default pointer 
MOVE.L #Table, VChrset load the new pointer 


(program goes here) 


MOVE.L (SP)+, VChrset reload default pointer 
CLR.L DO 
CLR.L D1 
RTS return to DOS 
Table DC.W XXXX >) RE XX ss data for ! 
DC.W g terminator 
DC.W RXXN MRE 6 data for " 
DC.W g 


had 


* 


* And so forth, for all ASCII characters 
* 


DC.W XiX Kp MEK XS GS data for tilde (7) 
DC.W g 


END Start execute at label "Start" 
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Installing a New Cursor 


The 7990 Bitmap cursors, Plot and Alpha, are each 
described by a set of data. This set is pointed to by 
pointers in the CMOS area, one pointer for the Plot cursor 
and one for the Alpha cursor. 


Plotcur EQU SE4Q16A 
Alphcur EQU SE4916E 


The cursor descriptor data is a list of up to 32 long 
words. Each long word describes the displacement of one 
pixel of the cursor, with respect to the center pixel of the 
cursor. The list is terminated with a zero word. Since this 
zero word is part of the descriptor, the center pixel of the 
cursor is always ON. | 


The displacements are given as addresses in Bitmap 
memory. Each pixel in Bitmap memory corresponds to a word 
(two bytes) of memory, so an X displacement of one pixel is 
produced by an address displacement of two. (Positive X 
displacement is to the right.) Similarly, a Y displacement of 
one pixel corresponds to an address change of 2848 bytes 
(1924 pixels per Y line of the screen, times two bytes per 
pixel. A positive Y displacement is in the down direction. 


A sample cursor might look like this, where X's 
correspond to pixels included in the cursor: 


X 
XXX 
Xx 


The data list for this cursor would be: 


+2 (the pixel to the right of center) 
-2 (the pixel to the left of center) 
+2848 (the pixel below center) 
-~2048 (the pixel above center) 
9 (the center pixel, and end of the list) 


To install a new cursor, first define it in the form 
above. Store this data in memory. Then, alter the pointer 
in CMOS (either Plotcur or Alphcur) so that it points to your 
data. Note that if you store your cursor in RAM other than 
CMOS, the description will vanish when system power is turned 
off, but the CMOS pointer will remain! This will cause you to 
have NO cursor at all. To reload CMOS defaults, use CTRL 
SHIFT Ml M2 RESET. | 
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KREKEKEKKKEKEKERKKEKEKEKKEKKKEKREKKERKEERKREKRKKEKRKEKEEKERKKKEKEKEKKEKEKKKKEKKREKER 


+ FF FF HF FH HF HF HF F 


PUTCURS 


PUTlLOop 


HiCMOS 
Plotcur 


Cursor 


ORG.L 


MOVE.L 
MOVE. L 


MOVE.L 
TST.L 
BNE.S 
MOVE.L 


CLR.L 
CLR.L 


RTS 


EQU 
EQU 


DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
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Sample program PUTCURS 


$1C3C 


#HiCMOS,A2 
#Cursor ,A3 


(A3)+,(A2)+ 
-4(A2) 
PUTloop 


#HiCMOS, Plotcur 


DO 
D1 


SEABED 
SE4G16A 


~4*1924 
—-4*1924+2 
-~4*1924-2 
-2*1924-4 
—-2*19024+4 
-4 

+4 

+6 

+8 
—-2*19024+8 
-2*19244+19 
—-2*1924+12 
—-2*19024+14 
—-4*1924+19 
—~4*1924+12 
-4*1924+14 
—~4*1924+16 
4*1924 


Installs a new cursor as the Bitmap plot cursor. 


This program stores its cursor descriptor in upper CMOS 
memory, unused by current 7909 software. 
compatible with future 7909 releases. 


This may not be 


We run in DOS area 


Point to some unused CMOS 
Point to our new cursor descriptor 


Copy a long word into CMOS 

Was it zero? 

No, continue copying 

Set up pointer to new cursor 
Flag no error occurred 


(We don't check for colon on line) 
Return to DOS 


CMOS area (unused in TERMEM 1.4) 
Plot cursor pointer 


New cursor descriptor 
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DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 
DC.L 


END 
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4*19024+2 

4*1924-2 

2* 1924-4 

2*1024+4 

2*1924+8 

2*19024+19 
2*1924+12 
2*1924+14 
4*1924+19 
4*1924+12 
4*1924+14 
4*1924+16 
0 


PUTCURS 


(end of list) 
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TERMEM Jump Tables 


This section describes the utilities available in CGC 
7998 PROM firmware. Each of these routines may be accessed 
through a subroutine call (JSR) to the appropriate address. 
BSR will not work, because the jump tables will be located 
beyond a 16-bit displacement from your program. 


Registers used in each routine are defined in this 
section. Unless noted, the routine only alters registers as 
necessary to return values to the caller. The notation 
"D1.W" means that the low word (16 bits) of Dl are used by 
the routine, D@.B means the low byte of D@, and so on. 


Names: 
BOOT 


Address: 
S80O094C 


BOOT boots the system. It does not return to the caller. 
One reason for calling BOOT would be to link in any RAM 
modules you have loaded into system memory. 


Name: 
CHARIN 


Address: 
S8GOGAC 


Entry: 
D1.W = logical device number to read from 


Exit: 
Zero flag SET if no character was available. 
zero flag CLEAR and character in D@.B if available 


CHARIN is the system character-in routine. It reads a 
character from a logical input device. Reading from device 9 
will get a character from the keyboard (if available), device 
l will be the serial port (these are the default 
connections). 


To wait for a character from CHARIN, use a loop on the EQ 
condition: 


Loop JSR CHARIN Get a character, if any 
BEQ.S Loop No character yet 


Escape and User codes are not processed by CHARIN, but are 


treated as normal characters. See CTRLOUT, CTRLIN' and 
ESCPROC below. 
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Name: 
CHAROUT 


Address: 
S800008 


Entry: 
DQ.B 
Dl oW 


character to pass to logical device. 
logical device number (@ to 4 are defined). 


CHAROUT is the system character-out routine. It passes a 
character to a logical output device. The system's device 
assignment structure will then pass the character on to a 
physical device, if possible. Logical output device 9 is 
normally used to put characters on the screen, and device l 
is normally connected to the serial port. If the character 
is part of a Mode or Plot code sequence, it will be processed 
when it reaches a Window (physical device). Escape and User 
codes are NOT processed by CHAROUT, but are treated as normal 
characters. To process Escape and User codes, see CTRLOUT, 
CTRLIN and ESCPROC below. 


Name : 
CTRLIN 


Address: 
$800014 


Entry: 
D1.W = logical device number to read from. 


Exit: | 
Zero flag SET if no character was available. 
Zero flag CLEAR and character in D@.B if available. 


CTRLIN is like CHARIN, but processes Escape and User codes 
before returning a character. It does this by calling CHARIN 
and then ESCPROC. If an Escape or User code was entered, it 
will be “eaten” by ESCPROC and the zero flag will be set, 
indicating that no character was available. 
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Name : 
CTRLOUT 


Address: 
$80901G 


Entry: 
Dg.B character to pass to logical device. 
D1.W logical device number. 
zero flag MUST be cleared. 


CTRLOUT is like CTRLIN, but processes Escape and User codes 
before passing the character on to the logical output device. 
It does this by calling ESCPROC (see below), then calling 
CHAROUT. 


NOTE: 


Do not call CTRLOUT if the zero flag is set -- 
your character will be ignored. 


Name: 
ESCPROC 


Address: 
$898018 


Entry: 
D@.B = character to process. 
zero flag MUST be cleared. 


Exit: 
Zero flag SET if character was "eaten" by ESCPROC. 
Zero flag CLEAR if character is still available. 


-ESCPROC handles Escape and User code processing. It is used 
by CTRLIN and CTRLOUT, and may also be called directly. 
ESCPROC detects Escape and User codes, and processes them by 
Setting the zero flag to indicate that the character was 
processed (and thus should not be considered available). 
After the Escape or User code is detected, ESCPROC will 
process subsequent characters to satisfy the argument list of 
that particular Escape or User function, then execute the 
function. This will normally be transparent to the user. 


Note that ESCPROC also processes the Create Buffer. 


Characters must flow through ESCPROC (or CTRLIN, or CTRLOUT), 
or they will not be put into the Create Buffer. 
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Name: 
Keystuff > 


Address: 
$890088 


Entry: 
D@.W = character to put into keyboard buffer 


Keystuff puts 8-bit characters into the keyboard input 
buffer. These characters will be read from the buffer along 
with any characters which were actually typed. Keystuff also 
checks if the Ml and/or M2 keys are active (signified by bits 
19 and ll being set), and performs translations if so. To 
insert a normal 8-bit character into the keyboard buffer 
uSing Keystuff, mask off these bits: 


AND.W #SFF,DO Make 8—bit only 
JSR Keystuff And put into buffer 


If the keyboard buffer is full, the character is discarded. 
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Name: 
NOISE 


Address: 
$800054 


Entry: 
AM points to a tone descriptor block (14 bytes). 


Exits: 
A® is incremented past block. 


NOISE feeds data to the sound generator. 14 bytes are loaded 
sequentially into the tone chip. These bytes go into 
registers @ through 13 of the tone chip (a General 
Instruments AY-3-8919), and control the following attributes: 


Register # Purpose 
) Fine Tune A (8 bits) 
1 Coarse Tune A (4 bits) 
2 Fine Tune B (8 bits) 
3 Coarse Tune B (4 bits) 
4 Fine Tune C (8 bits) 
5 Coarse Tune C (4 bits) 
6 Noise Period (5 bits) 
7 Output Enable 
8 A Amplitude (5 bits) 
9 B Amplitude (5 bits) 
19 C Amplitude (5 bits) 
il Envelope Period Fine (8 bits) 
12 Envelope Period Coarse (8 bits) 
13 Envelope Shape/Cycle Control (4 bits) 
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The tone generator has three voices, A, B, and C, each 
of which can be programmed to produce tone or noise. If a 
given voice is programmed for both tone and noise, noise will 
usually dominate. Tone and/or noise are enabled by register 
7s | 


A zero on any of the "“"n" bits enables noise from that 
channel, and a zero on any of the "t" bits enables tone from 
that channel. Unused channels are turned off by writing ones 
in the desired bits. 


Registers 8, 9 and 18 control the output amplitudes: 


| xX | xX | X | A | manual level ctrl | 
pom nm pena ey ff — + + + + 


A one in bit 4 specifies the channel's amplitude to be 
controlled by the envelope generator (Auto mode). If bit 4 
is a zero, the amplitude is fixed by the value in bits 9-3. 


The envelope generator is controlled by register 13: 


? 


7 6 5 4 3 2 1 4) 


fe nf a an oe anf oe an oe en oe ee ee HF 

| X | X | X | X Jeontlattk|] alt|/hold| 

fp ef nf a fe a ee ef ef 
Bits @-3 describe the envelope with "continue," 
"attack," "alternate" and "hold." See General Instruments 


literature for the envelope waveforms. The 7900 Hardware 
Reference Manual also has more information on the _ sound 
generator. 
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Name: 
PLRRCT 


Address: 
S800068 


Entry: 
DO .W 
D1.W 


radius 
angle in integer degrees 


Exits: 
DO.W 
D1.W 


X 
XY 


PLRRCT performs polar to rectangular conversion, using SIND@ 
and a technique Similar to the one described in SIND@, below. 


Name: 
READJOY 


Address: 
$80G0072 


Entry: 
Al.L 


pointer to joystick X, Y or Z@ axis. 


Exit: 
DO.W = value read from joystick. 


READJOY returns the current value of a joystick axis as a 
1@-bit number in the range 9 to 1923. Al must be set to the 
address of one of the joystick axes, as follows: 


X SFF8@C6 
Y SFF8@CA 
Z SFF8@CC 
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Name: 
PRTDEC 


Address: 
$890058 


Entry: 
D@.W = decimal number to convert to ASCII. 
Al.L = pointer to buffer where ASCII goes. 


Exits: 
Al is incremented past the string. 


PRTDEC prints a decimal number as an ASCII string. The 
string is placed into memory at (Al)+. 3 


Name : 
Scankey 


Address: 
S$886098 


Entry: 
D@.W = character to be converted and buffered. 


Scankey converts an 8-—bit code (produced by the upper half 
of the keyboard) into a stream of 7-bit codes, then stuffs 
them into the keyboard input buffer. See Keystuff, described 
above. 
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Names: 
SIND 


Address: 
$800064 


Entry: 
D@.W = angle in integer degrees. 


Exit: 
D@.W = sine of that angle. 


SIND@ takes the sine of an angle and returns the value as a 
l4-bit fraction. The form of the fraction is: 


Binary point 


S is the sign of the value (1 is negative). 


M is the mantissa (zero except if the value is one or 
negative). 


F are the fractional bits. 


The following example uses SINDS to compute 
Y*SIN(Theta). D@ is the angle Theta, and Y is in the lowe 
word of Dl. The value is returned in Dl. ’ 


JSR SIND@ Get sine of theta 

MULS Dg,D1 Y=Y*SIN (theta) 

ASL.L #2,D1 Adjust for 14-bit fraction 
SWAP D1 

EXT.L D1 Clear garbage from high word 
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Name: | 
STATIN 


Address: 
S8GOGCEC 


Entry: 
D1.W = logical device number to read from. 


Exit: 
D@.B = snapshot of oldest character (see below). 
zero flag CLEAR if character available, SET if not. 


STATIN is Similar to CHARIN and CTRLIN, in that it returns 
the status of an input device reflected in the zero flag. 
STATIN will also return a snapshot of the oldest character in 
the input buffer (if possible; some devices are not 
buffered). STATIN does not actually remove a character from 
a buffer. A character returned by STATIN will be returned 
again by subsequent calls to STATIN, and will also be 
returned by a call to CHARIN. Only after CHARIN or CTRLIN 
have been called, is the character removed from the device's 
input buffer. | 


Name: 
TERMEM 


Address: 
S800042 


TERMEM is the entry point for the Terminal Emulator, the 
main operating program in the CGC 7999. Programs can jump to 
this address to terminate execution without returning to DOS. 
TERMEM does not return to the caller. When entering TERMEM, 
it remains in the same status it was last in (half duplex, 
full duplex, or local). 
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Name: 
TCRSON 


Address: 
S80B0A4 


TCRSON will turn the cursor on in the currently specified 
cursor color. It determines whether the 7998 is addressing 
the Overlay or Bitmap and which mode it is in (Plot or Alpha) 
and turns on the appropriate cursor. 


Name: 
TCRSOFF 


Address: 
S8GO0GA8 


TCRSOFF determines whether the 7990 is addressing the 
Overlay or Bitmap and which mode it is in (Plot or Alpha) and 
turns off the appropriate cursor. 
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Plotting Functions 


Many of the plotting primitives in the 7988 may be 
accessed through jump tables. Plot functions are specific to 
a window, which means the system must Know which window to 
use for executing the plot routine. Data from the Window 
Table determines such things as the color of the plotted 
figure, and whether or not the figure will be filled. 


Before calling any of these plot routines, the data to 
be plotted must be scaled to screen coordinates, between @ 
and 1923. Data outside this range will be plotted 
unpredictably unless clipping is enabled. If clipping is 
enabled, out-of-range data will not be plotted. 


All of the plot routines discussed below need register 
AS to point to the base address of the current Window Table. 
This will be done automatically if your program is linked as 
a module, but if you are writing a transient, you must load 
AS in your program. If plotting in window A is desired, you 
may set up Ag by this code: 


BtmGWin EQU SC4G Pointer to W table base 
MOVE.L BtmGWin,A9 Get pointer 


Each Window Table occupies 512 bytes. If D@.L contains 
the window number (@ through 7, for windows named A through 
H), the following code would point A@ to the base of any 
Window Table: 


MOVE.L BtmGWin,A@ Get pointer 
ASL.L #5 ,D@ 

ASL.L #4 ,D@ — DG=512*DB 
ADD. L DO ,Ad Add to base 


Some of the functions described below require an 
argument list, which is passed on the "A3 stack." The values 
passed to the routine are pointed to by (A3), and the words 
following (A3). An area of the Window Table called Pargstk 
(Plot Argument Stack) is normally used to pass arguments, or 
your program can use other RAM for this purpose. To load the 
Pargstk area with four values for a vector, use the code on 
the next page. 
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Pargstk EQU $136 Offset in W table for plot args 
LEA Pargstk(A®),A3 Point to Pargstk 
MOVE.W X1,(A3) 
MOVE.W Y1,2(A3) Load XY values on A3 stack 


MOVE.W xX2,4(A3) 
MOVE.W Y2,6(A3) 
JSR FVECT Draw a vector 


Before calling any of these plot routines, the data to 
be plotted must be scaled to screen coordinates, between @ 
and 10923. Data outside this range will be plotted 


unpredictably. 
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These four routines plot figures according to the 
attributes of the Window Table pointed to by AM. Plotting 
will occur in .the Overlay or Bitmap, with or without 
patterns, according to the current status of the window. 


Name : 
ARC 


Address: 
S8GGG7C 


Entry: 
A3.L 
Ag .L 
D7.L 


pointer to X, Y, radius, start, delta (words) 
pointer to Window Table 
Window Table status 


Name : 
BVECT (Bold Vectors) 


Address: 
S$800074 


Entry: 
A3.L 
Ag .L 
D7.L 


pointer to Xl, Yl, X2, Y2 (words) and 4 scratch words 
pointer to Window Table 
Window Table status (see section A.190) 


Name: 
CIRCLE 


Address: 
$880078 


Entry: 
A3.L 
AQ .L 
D7.L 


pointer to X, Y, radius (words) 
pointer to Window Table 
Window Table status ‘ 


Name : 
CURVE 


Address: 
S800084 


Entry: 
A3.L 
AO .L 
D7 .L 


pointer to Xl, Yl, X2, Y2, X3, Y3, X4, Y4 (words) 
pointer to Window Table 
Window Table status 


non ul 
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Name: 
FVECT 


Address: 
S8G0G60 


Entry: 
A3.L 
AQ .L 


pointer to Xl, Yl, X2, Y2 (words) 
pointer to Window Table 


FVECT plots a vector in the Overlay or Bitmap, from (Xl, Y1) 
to (X2, Y2). FVECT vectors through the Window Table entry 
called Plotvect, which holds the address of a routine to plot 
a vector in the Overlay or Bitmap (see the discussion of 
Plotdot above). The address in Plotvect is loaded by any of 
the "MODE O" or "MODE T" commands. The current foreground 
color of the window (stored in the window table) is used 
unless patterns are active, OR UNLESS THE VECTOR IS 
HORIZONTAL. If Y1=Y2, a special fast vector routine is used 
which writes part of the vector through proprietary Color 
Status hardware. The color produced by Color Status is 
determined by loading the Color Status Foreground latch, a 
word at address S$E49016. To use FVECT properly, you must 
load the Window Table and the Color Status latch with your 
desired color. 


Name: 
PLOTXY 


Address: 
S8BGG5C 


Entry: 
DO .W 
D1.W 
Ag .L 


X value 
Y value 
pointer to Window Table 


PLOTXY plots a single dot in the Overlay or Bitmap, at the 
XY coordinate specified by D@ and Dl. PLOTXY vectors through 
the Window Table entry called Plotdot, which holds the 
address of a routine to plot a dot in the Overlay or Bitmap. 
Plotdot also holds the address of a routine which plots 
patterns in the Bitmap, if patterns have been enabled. This 
address is loaded by the "Mode O" or "Mode T" commands. The 
current foreground color of the window is used unless 
patterns are active. 


NOTE: 
Both FVECT and PLOTXY make use of the optional 


Hardware Vector Generator, if one is installed in 
your system. 
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Name : 
POLYG 


Address: 
$800082 


Entry: 
A3 ..L 
Ag .L 
D7 .L 


pointer to coordinate pairs (words) 
pointer to Window Table 
Window Table status 


POLYG is similar to the other plot routines described above, 
except that it can accept a variable-length argument list. 
The beginning of the list is pointed to by A3.L, and the end 
of the list is pointed to by an entry in the Window Table 
named Endbuf. Endbuf is a long word, and it holds the 
address of the word PAST the last coordinate in the polygon 
argument list. 


(A3) => | X1 | 


| X2 | Each item in this 
| ------------ | table is one word. 


Endbuf (A’)-> | EE | 
| 
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Pairs of words before and after the list (marked BB and 
EE above) are used as scratch areas by POLYG, and your 
program should allow room for them. 


The following code might be used to call POLYG: 


Pargstk EQU $136 Offsets in W table 
Endbuf EQU SAG 
LEA Pargstk (Ag) ,A3 Point to arg stack 
MOVE.L A3,-(SP) Save pointer 
MOVE.W X1,(A3)+ 
MOVE.W Y1,(A3)+ Load coordinates 
MOVE.W X2,(A3)+ onto A3 stack 


MOVE.W Y2,(A3)+ 


MOVE.W Xn, (A3)+ Put last values 

MOVE.W Yn, (A3)+ 

MOVE.L A3,Endbuf (AQ) | Set up end of list 

MOVE.L (SP)+,A3 Retrieve pointer to 
start of list 

JSR POLYG Do polygon 


Version 1.4 : Page E-49 


Jump Tables 7969 Operator's Manual Appendix E 


Inline Calling Sequences 


Name : 
INLINE 


Address: 
S8BAGGC 


Entry: 
A1.L 


il 


pointer to input buffer to be used 

(must be at least 84 characters long). 
Logical Input Device number to read from. 
control bits (see below). 


D1.W 
D7.B 


Exits: 
Zero flag SET if the user hit DELETE. 
Zero flag CLEAR if the user hit RETURN. 


INLINE is the 7998's general-purpose input routine, used by 
DOS, the Monitor, and Thaw. It reads a line of up to 83 
characters from the user, allowing character editing, Recall 
Last Line, etc. Bits in D7 control INLINE as follows: 


Bit Meaning if SET 

‘5S: Treat line-feeds as logical line separators. 
(newline character). 

3% Echo the input line to the screen after 
RETURN is pressed (in expanded form, Modes 
and tabs executed normally). 

2: Process Escape and User codes as they are 
entered. 

; 1: Use "A7" character set for control- 
characters displayed in compressed form. 

O: Do not display the characters as they are 


entered (you can't see what you type). The 
line will NOT be put into the Recall Buffer. 


DOS uses D7 equal to $@E, D1 equal to zero, and Al pointing 
to the DOS input buffer in low RAM. The end of the user's 
input line is indicated by a RETURN character (S$@D) in the 
buffer. Note that INLINE does not echo a RETURN/ LINEFEED 
when the user enters RETURN. 
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Name: 
INLINE] 
Address: 
$80AG018 
Entry: 
Al.L = pointer to input buffer to be used. 
D1.W = Logical Input Device number to read from. 
D2.L = length of input buffer. 
D7.B = control bits as described for the INLINE routine. 
A4.L = pointer to table of line termination characters. 
Exits: 


zero flag CLEAR if user hit RETURN; D@.L undefined. 


zero flag SET if the user entered a line delete 
character sequence. D@#.L = index into termination table 
of characters causing delete (i.e. the instruction MOVE.L 
lala will put the terminating characters into 
DO). 


INLINE1l is used to read lines of non-standard length. The 
length of the input buffer is given in D2.L. INLINE1 will 
read up to length-1 characters into the buffer, with the end 
of the line being flagged by the RETURN character (S$@D). 
INLINEL also provides for changing the list of characters 
which delete an input line (DELETE, BREAK and CTRL C are the 
standard line termination characters). 


Note that lines longer than 255 characters will not be 
stored in the Recall Buffer. 


As an example, suppose you are writing an editor. You 
want to be able to edit lines of up to 15@ characters. 
Furthermore, you want the characters CTRL X, INS LINE and DEL 
LINE to cause INLINE to abort input. The following is a 
program fragment to accomplish this. 
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* define input buffer storage 


* 


LINELEN 
INPBUF 


+t ob + 


TRMTBL 


* 


EQU 
DS.B 


DC.L 
DC.L 
DC.L 
DC.L 


* read a line 
* 


trmnég ed 


MOVEQ.L 
MOVEQ.L 
LEA 
LEA 
MOVE.L 
JSR 

BEQ 

BRA 
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159+1 
LINELEN 


define termination table 
(you must ensure that it is on an even boundary!) 


$18 
$89913E32 
$89013C32 
Q 


#Q ,D1 

#SQE,D7 

*+ (TRMTBL—(IPC+2)) ,A4 
*+(INPBUF-(IPC+2)),Al 
#LINELEN ,D2 

INLINE1] 

trmnég ed 

retin 


#4,DQ 


#8 ,D@ 


15@ characters + CR 
Input buffer 


CTRL—-X 
Insert line (MODE > 2) 
Delete line (MODE < 2) 


End of table marker 


Read from Device @ 

Control bits 

Pointer to termination table 
Pointer to input buffer 

Line Length 

Read line 

If LINE DELETE char entered 
Return entered 


See if INSERT LINE entered 
If yes | 

See if DELETE LINE entered 
If yes 
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Name: 
INLINE2 


Address: 
S8HAD1C 


Entry: 
Registers as set up by INITINL (routine described below) | 


Exits: 
Same as INLINE1 


INLINE2 is a low level routine used to get characters from 
the specified device and process them until RETURN or a line 
termination character is entered. Its use will be 
demonstrated in the INLINE3 example below. 


Name : 
INLINE3 


Address: 
S8GAG 20 


Entry: 
Registers as set up by INITINL or returned by INLINE3. 
D@.B = character to process. 


Exits: 
If D®.B was not a line termination character or RETURN, 
then D2.L=9; Zero flag is SET. Registers are updated for 
another character. 


If D9.B was RETURN, then D2.L=l, Zero flag CLEAR. 


If D#.B was a line termination character, then D2.L=2; 
zero flag is CLEAR; D@.L=index into termination table. 


Important! Between calls to INLINE3, the only registers that 
may be altered are D@, Al and A5. Changing any other 
registers will most likely crash the system. Also, INLINE3 
will destroy D@, Al and A5. 


INLINE3 is the workhorse of the INLINE system. It 
accepts characters one at a time and processes’ them, 
performing all editing functions. 


As an example of how these routines tie together, see 
the program fragment below. It shows how the DOS editor 
(should) display lines for editing. Assume that A5 points to 
the line to be edited and that it is terminated by a RETURN. 
The code on the following page will display the line, then 
let the user modify it: , 


~ 
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* 


* save pointer to char as INLINE3 eats things 


* 


MOVE.L A5,-(SP) 


% 


set up inline for a new line: 


MOVEQ.L #8,D1 
MOVEQ.L #5SQ9E,D7 


LEA *+ (TRMTBL—- (IPC+2)) ,A4 
LEA *+ (INPBUF-(IPC+2)) ,Al 
MOVE. L #LINELEN ,D2 

JSR INITINL 


Read from device 9 

Control bits 

Pointer to termination table 
Pointer to input buffer 
Length of input buffer 
Initialize the INLINE system 


* get characters from EDIT buffer and feed to INLINE 


Xl MOVE.L (SP)+,A5 
MOVE.B (A5)+,D@ 
CMP.B #CR,D@ 
BEQ.S X2 
MOVE. L A5 ,~ (SP) 
JSR INLINE3 
BRA.S X1 


* 


* let user edit the line 
* 


X2 JSR INLINE2 


* 


Get pointer to char 

Get the character 

End of the line? 

if 10. 2Sééws 

Remember: INLINE3 munches reg's 
Feed char to INLINE3 


* INLINE2 returns EQ/NE. Take appropriate action.... 


* 
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Name: 
INITINL 
Address: 
S80A024 
Entry: 
Al.L = pointer to input buffer to be used. 
D1.W = Logical Input Device number to read from. 
D2.L = length of input buffer. 
D7.B = control bits. 
A4.L = pointer to table of line termination characters. 
Exit: 


Registers as required by INLINE3. 


INITINL is used to initialize all information as required by 
the INLINE system. 


Name : 
INLHOME 


Address: 
S8GAG 28 


Entry: 
Registers as set up by INITINL. 


Exit: 
Cursor moved to home position of line. 


After a line has been output (see INLINE3 example), INLHOME 
could be used to put the cursor on the first character of the 
line before allowing the user to edit the line. The 
Chromatics editors using INLINE put the cursor at the end, 
but it is only a matter of taste. 
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Appendix F --— ASCII Codes 


This section includes a chart of the ASCII (American Standard 
Code for Information Interchange) characters, and a chart of the 
character fonts provided in the 7900. 


The 7988 uses some control-codes in ways not defined by 


ASCII. see Appendix A for the 7988's allocation of 
control-codes. 
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ASCII Codes 


Standard ASCII Character Set 


Value 
@ S08 CTRL @ Null 


bs nt bed 
NEY BODIHUaWDHE 


$91 
$92 
$93 
$04 
$05 
$86 
$97 
$@8 
$89 
SOA 
SOB 
S@C 
SOD 
SOE 
SOF 
$190 


S11 


$12 
$13 
$14 
$15 
$16 
$17 
$18 
$19 
SIA 
S1B 
$1C 
$1D 
SIE 
SIF 


Code 


CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 


CTRL 


CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 
CTRL 


I KN K KM EQCHNDWONOS SYPAGHTAMMOAOWYS 


Character 


Start of Heading 
Start of Text 
End of Text 

End of Transmission 
Enquiry | 
Acknowledge 

Bell 

Backspace 

Tab 

Linefeed 

Cursor Up 

Form Feed 

Return 


Shift Out 


Shift In 

Data Link Escape 
Device Control l 
Device Control 2 
Device Control 3 
Device Control 4 
Negative Acknowlege 
Synchronous Idle 
End Trans. Block 
Cancel 

End of Medium 
Substitute 
Escape 

File Separator 
Group Separator 
Record Separator 
Unit Separator 


Char 


} 2 F&F en Ho MO MY A Zee 


VV Ase ee OOND U® WHOH 2 


Value 


$40 
$41 
$42 


. $43 


$44 
$45 
$46 
$47 
$48 
$49 
S4A 
S4B 
SAC 
$4D 
S4E 
S4F 


$50 


$51 
$52 
$53 
$54 
$55 
$56 
$57 
$58 
$59 
SSA 
S5B 
$5C 
$5D 
SSE 
SSF 


Char 
@ 
A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
O 
P 
Q 
R 
S 
db 
U 
V 
W 
X 
Y 
vA 
[ 
\ 
] 


96 


Value 


S60 
$61 
$62 
$63 
$64 
$65 
$66 
$67 
$68 
$69 
S6A 
S6B 


S$6C 


$6D 
S6E 
S6F 
$70 
$71 
$72 
$73 
$74 
$75 
$76 
$77 
$78 
$79 
S7A 
$7B 
$7C 
$7D 
S7E 
S7F 


Char 


lw — INK KX EGCSTHNQDTOSD Se rUe TO hdoaa oD 


DEL 
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Regular and Alternate (A7) Character Fonts 


rc Dro rh te 3S > BM OM Mew 


Version 1.4 


] se woe oo” = < t 
‘ < € € € € 


ASCII Codes 


ce a) 
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